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How To Use the 
VP/ix Environment Guide 


INTRODUCTION 

Welcome to the VP/ix Environment Guide. This guide contains the 
information you need to install, maintain, and use the VP/ix™ 
Environment, Release 1.1.0. Whether you are an experienced VP/ix 
user or brand new to the VP/ix Environment, be sure to read the 
next few pages of this document. They will tell you what is 
contained in this guide and how to use the guide to your best 
advantage. 

What’s Included 

The VP/ix Environment Guide includes: 

• Overview of the VP/ix Environment 

Provides an introduction to the VP/ix Environment and describes 
how the MS-DOS® (DOS) and UNIX systems are integrated 
under VP/ix. 

• VP/ix and MS-DOS Primer 

Provides an introduction to the basic capabilities and commands 
available with VP/ix and DOS. This primer is a step-by-step 
guide to using DOS and UNIX® in the VP/ix Environment. 

• VP/ix Installation Instructions 

Provides step-by-step instructions on how to install and configure 
the VP/ix Environment. 


386/ix is a trademark of INTERACTIVE Systems Corporation. 
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• VP/ix Maintenance Procedures 

Provides a detailed description of the basic procedures required 
to keep the VP/ix Environment running smoothly. 

• VP/ix Environment Manual Entries 

INTERACTIVE’s proprietary manual entries, which supplement 
the AT&T User’s I System Administrator’s Reference Manual. 

• Reader’s Comment Form 

Provides you with a way to tell us what you like or dislike about 
this guide and to send us your ideas for making it even better. 

Where to Begin 

The VP/ix Environment Guide includes a variety of documents for 
users at varying levels of experience. Depending on your level of 
experience, you may want to use this guide in a number of different 
ways. The outline below provides some suggested ways to use this 
guide: 

• If you are a beginner ... 

First, read the “Overview of the VP/ix Environment” to become 
familiar with what the VP/ix Environment is. Then, work 
through the “VP/ix and MS-DOS Primer” to learn how VP/ix 
works in the DOS environment. 

• If you are an experienced DOS user ... 

Read the “Overview of the VP/ix Environment,” then read the 
following sections in the “VP/ix and MS-DOS Primer”: 
“GETTING STARTED WITH VP/ix,” “DIFFERENCES 
BETWEEN DOS AND UNIX FILE SYSTEMS,” and “USING 
DOS AND UNIX COMMANDS TOGETHER.” Refer to 
Appendix B of the “VP/ix and MS-DOS Primer” for important 
information about the differences between running native DOS 
and DOS under VP/ix. 

• If you are installing the system ... 

Read and follow the steps outlined in “VP/ix Installation 
Instructions.” Once you have completed the basic system instal¬ 
lation, go to “VP/ix Maintenance Procedures” for information 
about how to perform system maintenance tasks and tailor the 
system to match your requirements. 
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• If you want the latest system information ... 

Read the “VP/ix Environment Release Notes,” included with 
the VP/ix Environment. These notes provide you with up-to- 
the-minute information on what’s new in Release 1.1.0 of the 
VP/ix Environment. 

• If you want supplemental documentation ... 

Refer to the MS-DOS Reference Guide for detailed descriptions 
of DOS commands, program interface information, and other 
technical details. Refer to the VP/ix Technical Guide for a 
detailed, technical description of the internals of the VP/ix 
Environment. These documents are intended for experienced 
DOS and VP/ix users. Refer to the “Documentation Roadmap” 
included in the 386/ix Operating System Guide for a complete 
listing of all 386/ix™-related documentation. 


Conventions Used 


Throughout this guide, boxed words indicate keys on your keyboard. 
For example, | RETURN | refers to the key that moves the cursor to 
the next line. When you are instructed to ty pe a comm and, the 
command must always be followed by using the I RETURN] key. 


i w Keys on your keyboard may be label ed differen tly than those 
shown in this guide. For example, the I RETURN] key is labeled 
I ENTER | on some systems. If your hardware or software 
vendor supplies additional documentation with your system, 
read that documentation for information on key names before 
you continue with this guide. 


When a sequence of keystrokes using the I CTRL I key is listed, use 
the 1 CTRL I key as you would the I SHIFT) key. Hold down the 


ICTRLI key, and while it is down, press th e next key (or keys) 
specified. For example, to use the sequence ICTRLI s, you would 
hold down the I CTRL) key while typing the s key. 


Illustrations of computer screen displays, file names, directory 
names, and commands are printed in a typeface called constant 
width. Constant width text looks like the text produced by most 
typewriters. Whenever you are instructed to type anything shown in 
constant width in this guide, type it exactly as it is shown. 


Italics indicate the variables in a command or instruction format. 
In actual use, a real name or number replaces the italicized text. 
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For example, the sequence del filename shows the format for 
removing a file. The word filename is replaced with the name of a 
real file that you would like to remove from your system. Italics are 
also used for emphasis and when new terminology is introduced. 

Numbers preceded by the symbol § refer to section numbers within 
that document. 

References of the form name(n) refer to entry name in section n of 
your UNIX reference manual or of the “VP/ix Environment Manual 
Entries” included in this guide. 

The term “DOS” refers to MS-DOS version 3.3 running in the VP/ix 
Environment. The term “native DOS” refers to MS-DOS running as 
the native operating system on a PC. 

In the “VP/ix and MS-DOS Primer,” new commands are introduced 
in a double-boxed table. This display provides basic information 
about the command’s format (usage), description, options, and 
arguments. 


FOR MORE INFORMATION 

The documentation included in this guide provides information 
about how to install, use, and maintain the VP/ix Environment and 
supplements the information found in the MS-DOS Reference Guide 
and the VP/ix Technical Guide. For a complete listing of all 386/ix 
related documentation, refer to the “Documentation Roadmap” 
included in the 386/ix Operating System Guide. 
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Overview of the VP/ix Environment 


INTRODUCTION 

The VP/ix™ Environment is an enhancement to the UNIX® 
operating system that allows the MS-DOS® (DOS) and UNIX 
operating systems and their applications to execute on the same 
computer. The VP/ix Environment provides the DOS user with a 
multi-tasking, multi-user operating environment. For the UNIX 
user, the VP/ix Environment provides the DOS interface, which sup¬ 
ports thousands of “off-the-shelf’ applications. In addition, the 
VP/ix Environment bridges the gap between the UNIX and DOS 
systems by enabling users to: 

• Run UNIX commands from DOS. 

• Run DOS commands from UNIX. 

• Access UNIX files from DOS. 

• Run DOS commands from remote terminals. 

• Perform many other functions impossible with a DOS or UNIX 
system alone. 

How Does the VP/ix Environment Work? 

In past years, hardware and software vendors attempted to develop 
systems that would capitalize on the key advantages of both UNIX 
and DOS. However, the development of a truly integrated 


386/ix is a trademark of INTERACTIVE Systems Corporation. 

VP/ix is a trademark of INTERACTIVE Systems Corporation and Phoenix 
Technologies Ltd. 

UNIX is a registered trademark of AT&T. 

Hercules is a trademark of Hercules Computer Technology. 

Intel is a registered trademark of Intel Corporation. 

80386 is a trademark of Intel Corporation. 

AT and IBM are registered trademarks of International Business Machines 
Corporation. 

MS-DOS is a registered trademark of Microsoft Corporation. 
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DOS/UNIX environment was limited by the available hardware 
technology. Most solutions required that a computer run either 
DOS or UNIX — the two systems could not run simultaneously. In 
addition, data used by the two systems was stored in two distinct 
areas on the fixed disk of the computer. 

The introduction of the 80386™ microprocessor from Intel® has 
finally made the integration of UNIX and DOS possible. The archi¬ 
tecture of the 80386 chip is a technological advancement that per¬ 
mits the execution of DOS and DOS applications under UNIX. 

In the VP/ix Environment, the UNIX operating system acts as the 
primary (native) operating system, providing the multi-tasking, 
multi-user foundation for the computer. To access the VP/ix 
Environment, the user establishes a UNIX session by logging into 
the computer and starting the DOS operating system with the vp i x 
command. Once the VP/ix Environment is active, DOS programs 
and commands can be run just as if DOS were the native operating 
system on your computer. 

The combination of the 386/ix™ Operating System and the VP/ix 
Environment provides a powerful, fully integrated solution for users 
who want to retain their investment in DOS applications while 
acquiring the versatility of UNIX. The 386/ix Operating System 
gives you the power of UNIX, and the VP/ix Environment gives you 
the convenience of DOS. 

Who Can Use the VP/ix Environment? 

The VP/ix Environment can be used by executives, writers, secre¬ 
taries, clerks, programmers, and accountants — anyone who uses a 
computer. Users can purchase off-the-shelf applications designed to 
run on either the DOS or UNIX systems. Because the VP/ix 
Environment, together with UNIX, provides two operating system 
interfaces, users select the interface with which they are most 
comfortable. 

For application builders, VP/ix offers a powerful development 
environment. Developers can use both DOS and UNIX utilities, 
commands, and program development tools to create new applica¬ 
tions or customize existing applications quickly and easily. 
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With the VP/ix Environment, multiple DOS and UNIX applications 
can be run simultaneously. Other features include a file system that 
fully integrates DOS and UNIX and the ability to run UNIX 
commands under DOS and DOS commands under UNIX. Major 
features of this environment are described below. 

A Multi-User, Multi-Tasking DOS Environment 

The VP/ix Environment is a fully integrated combination of the 
MS-DOS and UNIX operating systems. With VP/ix, multiple users 
can simultaneously run DOS applications on the same system. The 
UNIX kernel is extended to provide the same efficient, interrupt- 
driven scheduling services to both DOS and UNIX applications. 
Under VP/ix, multiple DOS applications can run concurrently with 
conventional UNIX processes in a paged, virtual memory environ¬ 
ment. Each application runs in its own secure virtual address space. 

Support for DOS Applications 

VP/ix supports popular PC applications and DOS facilities that run 
on IBM® PC AT®-compatible systems. It includes support for direct 
hardware accesses to standard devices required by ill-behaved 
programs. VP/ix also provides support for up to 2 MB of virtual 
EMS (Expanded Memory Specification) for DOS programs, regard¬ 
less of a system’s actual physical memory configuration. 

Integrated DOS File System 

VP/ix provides a transparent integration of the DOS and UNIX file 
systems. Any program, regardless of whether it is a DOS or a 
UNIX program, can access and share the same files. 

Convenient User Interface 

Users can run DOS applications under VP/ix in one of two ways: by 
explicitly invoking the MS-DOS under VP/ix Environment or by 
running the application directly from the UNIX prompt. As a 
result, users can run DOS applications from the environment in 
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which they are most comfortable: UNIX or DOS. VP/ix also 
provides an optional pop-up menu interface, complete with help 
screens. 


Virtual Terminal Integration 

The VP/ix Environment is fully integrated with the 386/ix Virtual 
Terminal Manager. This enables a user to run multiple full-screen 
DOS and UNIX applications concurrently on the system console or 
other terminals with direct-write screens. The 386/ix Virtual 
Terminal Manager allows a user to switch the physical screen from 
one virtual screen to another with a “hot-key” sequence. 

Transparent Execution of UNIX and DOS Commands 

The VP/ix Environment allows users to run DOS programs directly 
from UNIX and UNIX programs directly from DOS. VP/ix allows 
users to combine UNIX and DOS commands with pipes and I/O 
redirection on a command line. 

Customized Version of DOS 

An enhanced version of MS-DOS is licensed and packaged with the 
VP/ix Environment to improve system performance. 

Graphic Display Support 

On the system console, DOS graphics are fully supported on the 
EGA, CGA, and Hercules™ graphics adapters. Multiple concurrent 
graphics applications are supported via the 386/ix Virtual Terminal 
Manager. 


FOR MORE INFORMATION 

The VP/ix Environment is supported by a complete set of documen¬ 
tation. For a complete listing of all 386/ix-related documentation, 
refer to the “Documentation Roadmap” included in the 386/ix 
Operating System Guide. 
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VP/ix and MS-DOS Primer 


INTRODUCTION 

What Will I Learn From This Primer? 

This primer is an introduction to the basic capabilities and com¬ 
mands available with VP/ix™ and DOS. In this primer you will 
learn: 

• How to enter and exit the VP/ix Environment. 

• How and when to use the VP/ix Interface Menu. 

• How to print files and run DOS applications in the VP/ix 
Environment. 

• What disks and drives are and how they are used with DOS. 

• How to use the VP/ix Z drive. 

• The components that make up DOS commands and how to exe¬ 
cute them. 

• How to give files names that will be acceptable to both the DOS 
and UNIX® operating systems. 

• What directories are and how to create, delete, and rename 
them. 


386/ix is a trademark of INTERACTIVE Systems Corporation. 

VP/ix is a trademark of INTERACTIVE Systems Corporation and Phoenix 
Technologies Ltd. 

UNIX is a registered trademark of AT&T. 
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1-2-3 is a registered trademark of Lotus Development Corporation. 
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Wyse is a registered trademark of Wyse Technology. 
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• What a file system is and the differences between the DOS and 
UNIX file systems. 

• How to redirect input and output. 

• How to use pipes and filters. 

• How to use DOS and UNIX commands together. 

• How the VP/ix Environment is configured. 

If you are a first time DOS user, read this entire primer. 

If you are an experienced DOS user, read the sections entitled “GET¬ 
TING STARTED WITH VP/ix,” “DIFFERENCES BETWEEN DOS 
AND UNIX FILE SYSTEMS,” and “USING DOS AND UNIX COM¬ 
MANDS TOGETHER,” then refer to Appendix B, which explains 
the important differences between running DOS under VP/ix and 
native DOS. 
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GETTING STARTED WITH VP/ix 
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In this section, you will learn: 

• How to begin and end a VP/ix session. 

• How to perform basic tasks, such as printing a file or running a 
DOS application. 

Before You Begin 

This document assumes that your system administrator has already 
installed your system, installed the VP/ix Environment, and set up 
your login account. Your login account is the information the com¬ 
puter uses to identify you and allow you access to the system. To 
log in, you must know your user name and your password (if one 
has been issued to you). If you do not know your user name and 
password, see your system administrator. 

The VP/ix Environment can be invoked from either a system con¬ 
sole or an ASCII terminal attached to a serial communications port 
on your computer. If you are operating VP/ix from an ASCII ter¬ 
minal, the VP/ix Environment may behave somewhat differently 
than described in this primer. ASCII terminal users should consult 
Appendix C for more information. 

Logging Into UNIX 

To use the UNIX system, you must turn on your computer or termi¬ 
nal and log in. If you are logging into the console, your screen will 
look similar to this: 

Console Login: 

If you are using a terminal other than the console, your screen will 
look similar to this: 

login: 

Type the user identification name (ID) assigned to you, then use 
I RETURN] , Your user ID can contain a maximum of eight charac¬ 
ters and can consist of uppercase letters, lowercase letters, and 
numerals. By convention, most user IDs on UNIX systems consist of 
lowercase letters. 
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After a user ID is entered, the system may request a password: 

login: tony 
Password: 

If you have been assigned a password, type your password when the 
Password : prompt appears and use I RETURN] . 

The system does not display the password you type on the 
screen. 

If you have not been assigned a password and the Password: 
prompt is displayed, simply use 1 RETURN I . Your screen will look 
similar to this: 

login: tony 
Password: 

*** Welcome to the UNIX Operating System. *** 

$ 

When you have completed the login procedure, the system 
displays a prompt on the screen. The prompt is a symbol, usually a 
dollar sign ($) or a percent sign (%), but because this character can 
be changed by your system administrator, your prompt may be 
different. The prompt indicates that the system is ready to receive 
information. When the prompt is displayed on your screen, you can 
enter a command or run an application program. 

Each time you log in, the system places you in your home directory. 
Your home directory serves as your personal work area. 

A directory (such as your home directory) is a special type of file 
that can contain both files and other directories. It is similar in 
function to a file cabinet: a file cabinet has several drawers (direc¬ 
tories), each of which can contain many folders (subdirectories), 
each holding one or more documents (files). You will learn more 
about directories in the section entitled “FILE SYSTEMS AND 
DIRECTORIES” in this primer. 

To determine the name of your home directory after logging into 
the UNIX operating system, type: 

$ pwd 
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Accessing the VP/ix Environment 

You will run the VP/ix Environment from the UNIX prompt. To 
access the VP/ix Environment, type the vpix command, followed 
by I RETURN I : 

$ vpix 

VP/ix displays several messages and then the default VP/ix prompt. 
Your screen will look similar to this: 

Welcome to MS-DOS Running in the VP/ix Environment 
VP/ix Z:\usr\tony> 

The default VP/ix prompt is: 

VP/ix Z : \directoryname> 

The word VP/ix indicates that you are running in the VP/ix 
Environment. Z : indicates that the UNIX file system on the fixed 
disk (the Z : drive) has been established as your default disk drive. 
The directoryname indicates that you are located in the directory 
from which you ran the vpix command; in the example above, 
\usr\tony is the name of the user’s home directory. You will 
learn more about disk drives and directories in subsequent sections. 
> is the prompt symbol that functions similarly to the UNIX $ 
prompt. When the VP/ix prompt is displayed on the screen, you 
can run DOS applications. 

If you are in a hurry, you can use the vpix command with its 
option -r to “quickboot” the VP/ix Environment. This means that 
DOS will start up immediately without displaying all the usual mes¬ 
sages on your screen. To start VP/ix quickly, type: 

$ vpix -r 


The VP/ix Interface Menu 

The VP/ix Interface Menu is used to control the VP/ix Environment. 
It facilitates resource sharing among multiple VP/ix users and 
manages each user’s individual VP/ix session. The VP/ix Interface 
Menu can be accessed at any time during a VP/ix session. All DOS 
processes are temporarily suspended when the VP/ix menu is active. 

ttr To access the menu on a system console with an 84-key key¬ 
board, use ISYS-REQ] , 
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To access the menu on a system console with a 101-key key¬ 
board (the functi on key s ar e across th e top rather than along 
the left side), use I ALT I and ISYS-REQ] simultaneously, followed 
by 0. 

wr To access the menu on an ASCII terminal, consult your system 
administrator for the proper key sequence. 

Throughout this document |SYS-REQl is used to invoke the VP/ix 
Interface Menu. Use the key sequence that is appropriate for your 
system. 

Use iSYS-REQl to access the VP/ix menu. You will see the menu 
and a display similar to the ones shown below; the VP/ix Interface 
Menu is on the left-hand side: 


VP/ix Version 1 . 1 

( ESC ) ape menu 
(F) loppy release 

(P) rinter flush 

(Q) uit VP/ix 

(R) eset VP/ix 
( S ) ound OFF 

(C)lose serial 
(E)nter shell 


Device 

Assignment 

A: 

/dev/rdsk/f Oql5dt 

C: 

/usr/vpix/defaults/C: 

Terminal 

Assignment 

AT 386 

/dev/console 


There may be more or fewer menu options, depending on your 
hardware. 

The secondary display shown on the right-hand side of your screen 
appears every time you invoke the VP/ix Interface Menu. It 
displays the user’s current default VP/ix Environment configuration 
and is for informational purposes only. No action is possible. Note 
that the values in the display will change if the user’s defaults 
change or if the user is configured to use specific DOS devices. For 
more information about this display, refer to the “The VP/ix 
Configuration File” section of this document and section 2 of 
“VP/ix Maintenance Procedures” in this guide. 

To select a menu option, position the cu rsor using the arrow keys 
(up-arrow Q] or down-arrow [J|) and use I RETURN] , or use the key 
(lowercase or uppercase) indicated in parentheses that corresponds 
to the option. The menu disappears from the screen after an option 
is selected. 
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You will use the VP/ix menu primarily to print text or data from a 
DOS application and to reset the VP/ix Environment. All of the 
options are described briefly below. Some are described in greater 
detail in later sections of this primer. 

If you are running a graphics application and invoke the VP/ix 
Interface Menu, it will not appear on your screen. However, 
selected options will take effect exactly as if you could see the 
menu. For exam ple, you will still be able to reset VP/ix by 
using 1SYS-REQ] and typing r. 

( Esc ) ape menu 

Removes the menu without invoking an option and returns 
you to your VP/ix session. 

( F ) loppy release 

Releases all diskette (floppy disk) drives. Diskette drives in 
the VP/ix Environment must be exclusively owned by one 
VP/ix user at a time. When your DOS application attempts 
to access a diskette drive, VP/ix automatically reserves that 
drive for your exclusive use, if it is available. However, the 
VP/ix system cannot automatically release the drive once it is 
acquired, since it has no way of knowing when you are 
finished with the drive. Therefore, you must explicitly 
release the drive with this option. This option is automati¬ 
cally invoked when you exit the VP/ix Environment. 

(P)rinter flush 

Sends text that is waiting to be printed to the UNIX printer 
spooler. In the VP/ix Environment, when you use a DOS 
command or a DOS application command to print data on a 
printer, the print data is stored rather than sent directly to 
the printer. On a multi-user system such as 386/ix™, some¬ 
one else may be using the printer at any given time. Since 
there is no explicit “done with printer” operation in DOS, 
you must tell the VP/ix system to actually send the stored 
data to the printer via the UNIX printer spooler. The data 
will then be queued for printing and actual printing will 
begin as soon as the printer is available. (The printer is also 
automatically flushed when you exit the VP/ix Environ¬ 
ment.) Note that if you are printing a large file, you must 
wait a few minutes after using the DOS command or the 
DOS application command before you flush the printer, or 
your print job may be split into parts. 



8 


VP/ix and MS-DOS Primer — Release 1.1.0 


( Q ) ui t VP/ix 

Exits the VP/ix Environment. This is the same as typing 
quit at the VP/ix prompt, except that the screen will be 
restored to the way it looked when you entered VP/ix. The 
system automatically releases all system resources (diskette 
drives, ser ial ports) when this option is used. Simply use 
iSYS-REQl and type q to exit the VP/ix Environment. 

(R)eset VP/ix 

Reboots the VP/ix Environment. This option is equivalent to 
using the standard I CTRL I |ALT| I DEL I keyboard sequence to 
reboot (which may be used in the VP/ix Environment as an 
alternative to this menu option); the VP/ix Environment is 
restarted just as if you had exited and reentered it. This 
option is used if your DOS application has inadvertently 
locked your terminal. 

( S ) ound OFF 

( S ) ound ON 

This option turns off and on the “beeps” that the system pro¬ 
duces. If the computer beeps frequently while you are using 
an application or a game, you may want to turn off the sound 
by selecting this option. When the ( S) ound OFF option 
has been selected, the menu displays this option as 
( S ) ound ON. If you turn on the sound again by selecting 
this option, the menu displays the option as ( S ) ound OFF. 

(C)lose serial 

As with diskette drives, serial communications ports must be 
owned exclusively by one VP/ix user at a time. The VP/ix 
Environment has no way of knowing when you are finished 
with a port unless you indicate to the system that you are 
finished. If you have been using a serial communications 
port (e.g., with an application such as CrossTalk™ or Pro- 
Comm), use this option to release it as soon as you have 
completed your session, to make the port available to other 
users. This option will appear on your menu if your system 
configuration supports it. This option is automatically 
invoked when you exit the VP/ix Environment. (Note that 
the VP/ix Environment does not currently support the serial 
communications devices named COM1 : and COM2: on 
MULTIBUS™ systems.) 
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(E)nter shell 

Invokes a new UNIX shell without terminating the VP/ix ses¬ 
sion (see the section entitled “Invoking the UNIX Shell From 
the VP/ix Interface Menu”). When you exit the new UNIX 
shell, the current VP/ix screen (without the menu) is 
redisplayed and the VP/ix session is resumed. 

Running DOS Applications 

In the VP/ix Environment, DOS applications are installed and run 
using the same procedures you normally use in a native DOS 
environment. Ask your system administrator or refer to the docu¬ 
mentation supplied with your DOS application to learn how to run 
your application. For example, if you have a word processing appli¬ 
cation that you normally run by using the word command, type 
word at the VP/ix prompt: 

VP/ix Z:\usr\tony> word 


Printing From the VP/ix Environment 

In most cases you must start two distinct processes to print from the 
VP/ix Environment. You must: 

• Initiate the print request, either through a DOS command or 
from within a DOS application. 

• Cause the print request to be passed to the spooler program so 
that it can be queued for printing. 

If you use IPRT-SCR] to print the current screen on the system con¬ 
sole, VP/ix automatically sends the print request to the printer. If 
you initiate a print request from a DOS application, following the 
instructions provided with that application, or use a DOS print com¬ 
mand at the VP/ix prompt, the text or data that would normally 
begin printing at this point is instead stored by the VP/ix 
Environment. 

You must then instruct the system to send the p rint request to the 
printer. Access the VP/ix menu, using iSYS-REQl : 
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VP/ix Version 1. 1 

(ESC)ape menu 

(P) loppy release 

(P) rinter flush 

(Q) uit VP/ix 

(R) eset VP/ix 
( S ) ound OFF 
(E)nter shell 

Type p to s elect the ( P ) r inter flush option. It is not neces¬ 
sary to use | RETURN! . The menu disappears from the screen, and 
your data begins to print as soon as the printer is available. 

If you are printing a long file, you must wait a few minutes after 
using the DOS or DOS application print command before you flush 
the printer. If you do not wait for the DOS command to complete 
before using the Printer Flush option, only part of your print 
job may appear. The rest will appear the next time you use the 
Printer Flush option. A rule of thumb is to wait approxi¬ 
mately 1 minute for every two pages of print job before flushing the 
printer. 

The printer is also automatically flushed when you exit the VP/ix 
Environment. 

Exiting the VP/ix Environment 

You may exit the VP/ix Environment at any time. If you are using 
an application that is stored on a diskette, always exit the VP/ix 
Environment when you have finished so that the diskette drive will 
become available to other users. If your DOS application requires 
that you save or exit your file, use the appropriate commands before 
you exit the VP/ix Environment. 

To exit the VP/ix Environment, type quit at the VP/ix prompt: 

VP/ix 2:\> quit 

$ 

You will be returned to the UNIX prompt. 
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When the UNIX prompt displays, you can exit (log out of) the 
UNIX system. To exit the UNIX system, hold down the ICTRLI key 
and simultaneously type d, or type exit at the prompt: 

$ exit 

The computer displays the login: prompt, indicating that it is 
ready to accept a login name for the next session. 
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UNDERSTANDING DISKS AND DRIVES 

This section provides an overview of the fixed disk drive and 
diskette drives, which are the primary media for storing data and 
programs. In this section you will learn: 

• What fixed disks and diskettes are. 

• What a disk drive is. 

• How to access a disk drive. 

• What the Z drive is. 

What Is a Disk? 

All commands and data are stored on a medium called a disk. 
There are two kinds of disks: fixed disks and diskettes. A fixed 
disk is a collection of rotating, magnetized disks sealed into a unit 
that resides permanently in your computer. A diskette is a remov¬ 
able medium composed of a magnetized surface, on which informa¬ 
tion can be stored. 

What Is a Disk Drive? 

Fixed disks and diskettes are accessed using a device called a disk 
drive. There are two kinds of disk drives on DOS systems: fixed disk 
drives and diskette drives. The fixed disk drive is usually the 
default drive on a computer, that is, it is automatically made the 
current drive when you invoke the VP/ix Environment. 

On DOS systems, each available drive is assigned a single letter as 
its name. The default drive name assignments in the VP/ix 
Environment are shown below: 


Drive Name 

Device 

A 

the first diskette drive 

B 

the second diskette drive 

C 

the bootable DOS image 
on the fixed disk drive 

Z 

the UNIX file system 
on the fixed disk drive 
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Drive assignments and the default drive assignment can be altered. 
Consult your system administrator for more information. 

Only one drive is active at any given time. To use a different drive, 
you must activate it with a command. Note that before you 
activate a diskette drive, you must insert a diskette into that drive. 

To activate a new drive, type the name of the drive and a colon (:), 
followed by I RETURN) . For example, if your current drive is Z, the 
UNIX file system on the fixed disk, you may activate the first 
diskette drive by inserting a diskette into that drive and typing: 

VP/ix Z:\usr\tony> a: 

The first diskette drive, A, will become the active drive. Your 
prompt will now resemble this: 

VP/ix A:\sales> 


Accessing the Diskette Drive 

On a VP/ix system the diskette drive is referred to as drive A. 

wr Your environment must be configured correctly to use drive A; 
not all system users have access to it. You can tell if you have 
access to drive A: by using the pop-up VP/ix Interface Menu. 
The secondary display that appears on the right will have an 
entry for A: in it if you are allowed access to the diskette 
drive. If it does not and you require this access, consult your 
system administrator. 

Only one user can use the diskette drive at a time. If another per¬ 
son is using the diskette drive, you will not be able to access it. If 
you are using the diskette drive, when you exit the VP/ix Environ¬ 
ment, it is automatically released. If you are finished with the 
diskette drive, but want to remain in the VP/ix Environment, you 
should releas e the diske tte drive by invoking the VP/ix Interface 
Menu (using iSYS-REOl ) and selecting the ( F) loppy release 
option. 

Using the Z Drive 

Unlike single-user computers running DOS, the VP/ix Environment 
supports a multi-user file system, located on the Z drive. The Z 
drive contains the UNIX file system on the fixed disk. This is the 





14 


VP/ix and MS-DOS Primer — Release 1.1.0 


same file system you access when you log into the 386/ix Operating 
System. (For more information on UNIX file systems, refer to the 
“UNIX Primer” in the 386/ix Operating System Guide.) 

Only files accessed through the UNIX file system on the Z drive 
can be shared by multiple VP/ix users. 

All VP/ix users on your computer can simultaneously access the Z 
drive; therefore, files and directories that others need to access fre¬ 
quently should be created on the Z drive. Although the files on the 
Z drive are UNIX files, all the DOS commands described in this 
primer can be used with them. 
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USING DOS COMMANDS 

Once you have entered the VP/ix Environment, you can run both 
DOS and UNIX commands and programs. This section discusses 
how to use DOS commands. In this section you will learn: 

• What a DOS command is. 

• DOS command syntax. 

• What options and arguments are. 

• How to issue a DOS command. 

• How to stop a DOS command. 


What Is a Command? 


The words command and program are nearly synon ymous. In sim¬ 
ple terms, the user types a command, followed by I RETURN] , and 
the operating system executes the program that performs the user s 
“command.” 


Commands are typed at the system prompt. When a command is 
entered, it is called a command line. It can have three parts: the 
command itself, its options (also referred to as switches and flags), 
and its arguments. The command name is the name of the program 
that performs the desired action. An option is a special kind of 
argument that is specific to a particular command. It changes the 
behavior of the command in some way. In the DOS operating sys¬ 
tem, an argument usually consists of a file, directory, user name, or 
drive name. (The UNIX operating system does not use drive 
names.) An argument gives the system information that is required 
to process a specific command or to change the standard behavior of 
a command. 


Each command line is t erminate d by using IRETURN] . The 
I RETURN I key is labell ed I ENTER I on some systems and is fre¬ 
quently referred to as I ENTER I in DOS software documentation. 
When the I RETURN I is received, the command is sent to the operat¬ 
ing system for execution. 
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Command Syntax 

The UNIX operating system is case sensitive, which means that it 
distinguishes between upper- and lowercase letters. The DOS sys¬ 
tem is case insensitive, that is, it does not distinguish between 
upper- and lowercase letters. Throughout this document, commands 
are shown in lowercase letters; however, you can use any combina¬ 
tion of uppercase and lowercase letters when typing commands to 
the DOS operating system. It converts everything you type to 
uppercase letters. 

When using a UNIX command, you may not use either upper- 
or lowercase characters; you must type the command in the 
correct case. 

DOS options typically begin with a forward slash (/). Each com¬ 
mand, option, or argument consists of one word, which is interpreted 
as a group, or string, of characters surrounded by spaces. 

If you make an error when typing a command, use | BACKSPACE] to 
correct the error. You may use the left and right cursor positioning 
keys (such as E3)> but you may not use the up and down cursor 
positioning keys (such as Q]). 

Always type the command name first, followed by a space. Next 
type the desired option or options, each followed by a space, then 
any arguments, separated by sp aces. (You can also use the semi¬ 
colon (;), the equal sign ( = ), or |TAB| between DOS commands and 
their options. In this manual, commands and options are shown 
separated by a space.) 

This primer presents commands in the following format: 
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COMMAND NAME 

command name 

FORMAT 

command [option(s)] argument(s) 

DESCRIPTION 

A brief description of what the command 
does. 

OPTIONS 

A list of the most useful options and a 
brief description of each. 

ARGUMENTS 

Mandatory or optional arguments. 


If an argument is not required, it is shown in square brackets [ ]. 
Options are always “optional,” so they are always shown in square 
brackets. Only the most common options and arguments are dis¬ 
cussed in this primer. Some commands may also include step-by- 
step instructions. For a complete list of the available options and 
arguments, refer to the MS-DOS Reference Guide. 

Command Names 

Command names are short or abbreviated words that describe the 
programs they invoke. They are deliberately kept short to save time 
and reduce typing errors. On DOS systems, you can abbreviate 
some command names to two or three letters. For example, you can 
either type rename or ren when using the rename command. 
(Note that this is not true on UNIX systems.) In the discussion of 
each command, there may be information on acceptable abbrevia¬ 
tions (or substitutions) that can be used when typing the command. 
For complete information on command abbreviations, refer to the 
MS-DOS Reference Guide. 

Using a Simple Command 

The dir command is an example of a command that can be exe¬ 
cuted using only the command name. It is used to list the names of 
the files and directories in the current directory. Files and direc¬ 
tories are discussed in more detail in the sections entitled “USING 
AND NAMING FILES” and “FILE SYSTEMS AND 
DIRECTORIES”. 
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COMMAND NAME 

dir 

FORMAT 

dir [/w] [ drive: Upathname] 

DESCRIPTION 

Displays information about the files and directories 
in the specified drive and directory. If no drive or 
path is specified, list all files and directories in the 
current directory on the default drive. 

OPTIONS 

/w Display the names of all files and directories 
in the current directory, listed across the 
screen. 

/p Display the names of all files and directories 
in the current directory one page at a time. 

ARGUMENTS 

A drive and a path name to a file or a directory can 
be specified. If no drive is specified, use the default 
drive. If no path name is specified, list all directory 
entries in the current directory. 


If you type dir at the prompt the system displays information 
about the file and directory names on the default drive in the 
current directory. For example, if the current drive is C and you 
type: 

VP/ix C: \> dir 

the screen will look similar to this: 

Volume in drive C is DOS 
Directory of C:\ 


COMMAND 

COM 

23612 

4-21-87 

12 : OOp 

BACKUP 

EXE 

22906 

4-21-87 

12 : OOp 

CHKDSK 

EXE 

9680 

4-21-87 

12 : OOp 

MODE 

EXE 

13652 

4-21-87 

12:OOp 


4 File(s) 232608 bytes free 


The dir command lists the full names of all files and directories in 
the current directory, and also the size in bytes (a unit for measur¬ 
ing disk space), the time of last modification for each file and direc¬ 
tory, and the number of files and the amount of free space available 
(in bytes). Note that the dir command does not display the period 
that separates a file name from its extension. 
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After issuing a command, you may be instructed to provide more 
information. Usually the command provides a description of the 
appropriate responses. 

When the instruction Press any key appears, you may press 
any letter of the alphabet (a-z), number (0—9), or the 
I SPACEBAR] key. 

Command Arguments 

An argument gives the system information that is required to pro¬ 
cess a specific command or to change the default, or standard, 
behavior of a command. DOS command arguments usually include 
the following components: 

drive: Disk drive name. A disk drive is either a fixed disk 

drive or a diskette drive. Fixed disk and diskette 
drives are sometimes referred to as source drives and 
target or destination drives. A source drive is the 
drive from which you will be transferring information. 
A destination drive is the drive to which you will be 
transferring information. 

file name The name of a document or collection of information 
stored on the computer, including the file name exten¬ 
sion, if one exists. The file name extension is a suffix 
of one to three characters, separated from the file 
name by a period (.). The file name option never 
refers to the name of a device or a drive. You must 
include the file name extension when referring to a file 
that has a file name extension. File names are dis¬ 
cussed in more detail in the section entitled “USING 
AND NAMING FILES.” 

path name The sequence of directory and file names that de¬ 
scribes the location of a file or directory on the sys¬ 
tem. The path name of a file follows the general 
format: 

\directory\directory\filename 

Path names are discussed in greater detail in the sec¬ 
tion entitled “FILE SYSTEMS AND DIRECTORIES.” 
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strings Strings of text that are specific to a command and 

give the DOS system additional information. 

Some commands require one or more arguments; arguments are 
optional for other commands. The dir command, for example, 
accepts a file or directory name as an optional argument. If you 
type dir followed by a file name, the system displays the file name 
and information about the file if the file exists in the current 
directory: 

VP/ix Z:\usr\tony> dir budget 

Volume in drive Z is UNIX 
Directory of Z:\usr\tony 

BUDGET TXT 23612 4-21-87 12:00p 

1 File(s) 2232008 bytes free 

If a directory name is used as the argument, the system displays the 
names of all the files and directories in that directory: 

VP/ix Z:\usr\tony> dir letters 

Volume in drive Z is UNIX 
Directory of Z:\usr\tony\letters 


ACKNOWL 

TXT 

23612 

4-22-87 

10:54a 

MARKET 

TXT 

22906 

4-21-87 

11 : 02a 

MARKET2 

TXT 

23332 

4-21-87 

11 :45a 

HARRIS 

TXT 

34118 

4-19-87 

9:02a 


4 File(s) 2232608 bytes free 


You can also display the files on a specific drive by specifying the 
drive name as an argument. A drive name tells the DOS operating 
system to look on the diskette in a specific drive to find the named 
file. For example, to display the files and directories in the default 
directory on drive B, you would make sure a diskette is in the B 
drive and type: 

VP/ix Z:\usr\tony> dir b: 


Command Options 

An option is a special kind of argument that is specific to a particu¬ 
lar command. As its name implies, an option is not required, but it 
provides additional versatility when used with a command. Most 
DOS options begin with a forward slash (/). Note that this is 
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different from the UNIX system. UNIX options begin with a dash 
(- ). Some DOS commands accept both arguments and options. 

For example, the dir command can be used with the /w or “wide” 
option, which displays the names of the files and directories in 
columns across the display. If you type: 

VP/ix C:\> dir /w 

then the screen will look similar to this: 

Volume in drive C is DOS 
Directory of C:\ 

COMMAND COM BACKUP EXE CHKDSK EXE MODE EXE 
4 File(s) 232608 bytes free 


Stopping Commands 


You can per manently stop commands while they are running by 
using ICTRLI and typing c. 


When commands produce a large amount of output on the scr een, 
the display automatically scrolls to the next sc reen. Use ICTRLI and 
type s to suspend the scrolling. Use ICTRLI and type q to resume 
scrolling. 
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USING AND NAMING FILES 

This section reviews how DOS files are used and named. In this sec¬ 
tion you will learn: 

• What a file is. 

• How to name a DOS file. 

• How to name a file so that it is acceptable to both the DOS and 
UNIX systems. 

• What DOS wildcards are and how to use them in DOS 
commands. 

What Is a File? 

A file is a named collection of related information stored on a com¬ 
puter, a letter or a report, for example. You create a file each time 
you enter and save data or text at your terminal. Files are also 
created when you write, name, and save programs. 

Naming DOS and UNIX Files 

All programs, text, and data on disks or diskettes reside in files. 
Each file has a unique name. In DOS, a complete file name consists 
of a file name and its extension. File names can be one to eight 
characters and can contain letters, numbers, and symbols. The 
optional file name extension can be one to three characters and can 
contain letters, numbers, and symbols. It must be separated from 
the file name by a period. 

A typical DOS file name looks like this: 

FORECAST.EXE 

FORECAST is the file name; EXE is the file name extension. 
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Examples of other acceptable file names are: 

accounts.feb 
budget.84 
smithco.ltr 
chapter 1.nvl 
CHAP. 6A 
schedule 
Workup.jun 

If you use both upper- and lowercase letters in file names, be aware 
that the DOS system converts all lowercase letters into uppercase. 
Therefore, the file names letter. Letter, and LETTER are all 
viewed by DOS as the same file. It is a good idea to use only lower¬ 
case letters in your file names. 

The DOS and UNIX operating systems have different file naming 
conventions. In contrast to DOS file names, UNIX file names can be 
one to fourteen characters long and can include both uppercase and 
lowercase letters. In the UNIX system, lowercase letters are not 
converted to uppercase letters. Therefore, the names letter, 
Letter, and LETTER are all viewed by UNIX as different files. 
UNIX file names do not have “extensions,” so they can contain 
more than one period and have more than three characters after a 
period. 

When accessing the UNIX file system through the DOS Z drive, 
UNIX file names that do not follow the DOS naming conventions 
will be changed into names that do follow the DOS conventions. 
These names will contain one or more tildes (~), so it will be easy 
to see which UNIX file names do not follow the DOS conventions. 

To make a UNIX file name identical when viewed through both 
UNIX and DOS, give it a name that follows all the limits 
imposed on DOS file names and contains only lowercase letters. 
It is probably best to use only letters and numbers in your file 
names and extensions, although some other characters are 
allowed. 


Invalid File Nantes 

The DOS operating system treats some device names in special 
ways. Certain three-letter names are reserved for the names of 
these devices. These three-letter names cannot be used as file 



24 VP/ix and MS-DOS Primer — Release 1.1.0 

names, but can be used as extensions. You must not use any of the 
following as file names: 


AUX 

Refers to input from, or output to, an auxiliary 
device, such as a printer or a diskette drive. 

COM1 

Refers to the first asynchronous 
communications port. 

COM2 

Refers to the second asynchronous 
communications port. 

CON 

Refers to keyboard input, or to output to the 
terminal console (screen). 

LPT 1 

Refers to the first line or parallel printer. 

LPT2 

Refers to the second line or parallel printer. 

LPT3 

Refers to the third line or parallel printer. 

NUL 

Is used when you do not want to create a file, 
but the command requires an input or output 
file name. 

PRN 

Refers to the printer. 


You may not add device designations or file name extensions to 
these file names. The DOS operating system assumes that all files 
that contain these characters refer to the devices listed above. For 
example, CON. XXX is interpreted as a reference to the console by 
DOS. It cannot be used to name a file stored on a fixed disk or 
diskette. 

Wildcards 

A wildcard is used to match a character or a string of characters in 
a file or directory name. It is a type of shortcut that can be used in 
commands that require file names and extensions as arguments. A 
wildcard is also referred to as a pattern matching character. 
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Wildcards are convenient because they enable you to use a file name 
or group of file names without having to type the complete name. 
Wildcards can also be used when you only remember part of a file 
name. 

There are two DOS wildcard characters: 

? Matches any one character. 

* Matches zero or more characters. 

When you create new files, be very careful not to use a wild¬ 
card character as part of the file name. It is very difficult to 
access or remove a file if there is a wildcard character in its 
name. 


WILDCARD 

? 

FORMAT 

string? 


Istring 


? string? 


string ? ? 

DESCRIPTION 

Substituting a question mark in a 


file or directory name argument 


matches any one character for 


each ? supplied. 


The question mark means that no character or one character can 
occupy that position. For example, the DOS command: 

VP/ix Z:\usr\tony> dir testPrun.exe 

lists all directory entries on the default drive that begin with the 
string test, have one character or no characters in the next posi¬ 
tion, are followed by the letters run, and have a file name exten¬ 
sion of . exe. Here are some examples of files that might be listed 
using the above dir command: 

test1run.exe 
test2run.exe 
testbrun.exe 

An asterisk (*) means that zero or more characters can occupy that 
position or any of the remaining positions in the file name or exten¬ 
sion. For example, the command: 
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VP/ix Z:\usr\tony> dir test*,exe 

lists all directory entries on the default drive with file names that 
begin with the characters test and have an extension of . exe. 
Here are some examples of files that would be listed using the above 
dir command: 

test.exe 
test 1.exe 
test2run.exe 
test6run.exe 
testall.exe 

To list the directory entries for all files named accounts on drive 
A (regardless of their file name extensions), type: 

VP/ix Z : \usr\tony> dir a : accounts . * 

To list the directory entries for all files with file name extensions of 
. txt (regardless of their file names) on the disk in drive B, type: 

VP/ix Z : \usr\tony> dir b: * . txt 

This command is useful if, for example, you have given all your text 
files a file name extension of .txt. By using the dir command 
with wildcard characters, you can obtain a list of all your text files 
even if you do not remember all their names. 

The wildcard designation * . * refers to all files in the current direc¬ 
tory. Note that this can be very powerful and destructive when 
used with DOS commands. The command: 

VP/ix Z:\usr\tony> del *.* 

deletes all files in the current directory, regardless of file name or 
extension. 

The DOS wildcards are similar to two of the UNIX wildcard charac¬ 
ters, ? and *. For more information about UNIX wildcard charac¬ 
ters, see the “UNIX Primer” in the 386/ix Operating System Guide. 
For more information about DOS wildcard characters, see the MS- 
DOS Reference Guide. 
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This section discusses directories and file systems and their place in 
the DOS system. In this section you will learn: 

• What a directory is. 

• What a file system is. 

• What the root directory is. 

• What a path name is. 

• Path name shortcuts. 

• How to create a directory. 

• How to change from one directory to another. 

• How to delete a directory. 

• How to rename a directory. 

Directories 

Directories are used to organize files into convenient groups. A 
directory is a special kind of file that stores other files and informa¬ 
tion about the files and subdirectories stored in it. Directories con¬ 
tain information about the sizes of the files, their locations on the 
disk or diskette, and the dates that they were created and last 
updated. DOS directories are named using the same conventions 
used for DOS file names. 

File Systems 

Information on the computer is stored in an organized structure, 
called a hierarchical file system. A file system is a collection of 
individual files that are stored on a disk. It is called hierarchical 
because of its multi-level structure. A single master directory is at 
the top level, and additional files and directories are defined at vari¬ 
ous levels below it. 

The master directory for the entire system is called the root direc¬ 
tory. It is the highest-level directory in the file system structure and 
is named backslash (\) on DOS systems. (On UNIX systems, the 
root directory is named slash (/).) The root directory contains 
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several directories and each of these directories can contain other 
directories. Because a hierarchical file system is sometimes visual¬ 
ized as a “tree,” each new directory created on the system can be 
viewed as a new branch added to the directory tree. 

Here is a diagram of a simple directory structure for a computer 
user named Diane: 


1- vendors 


- paper.sup 

- rentals 

- food 


\di 


me 



children 
adults 


The root directory, (\), contains a directory named diane. 
\diane contains two directories: vendors and orders. 
These in turn, hold other files and directories. 

The organization of your files and directories can be changed at 
any time to fit your needs. For example, you might have a direc¬ 
tory in your home directory called memos, which contains all the 
memos you have written. Or, you could have a letters direc¬ 
tory, which could contain a number pf other directories, one for 
each of your major projects: 


i- coffee 


i- memos- 


grants 


J - pick.prj 


\kathryn 


letters- 


lloyd 


adrian 
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If you deal with different regional offices, you might have a major 
directory for each region, with each region directory containing 
parallel directories for letters, memos, and forecasts: 


t - west- 


\tony 

- east- 


letters 

memos 

forecast 

june 
july 
august 


letters 

memos 

forecast- 


The only limit on the number of files and directories you can have, 
or the number of directory levels you can have, is the amount of 
disk or diskette space available to you. 

File Names and Path Names 

When you want to access a directory or file in the file system, you 
use a path name. A path name is a sequence of directory names 
and file names, separated by backslashes, that designates the loca¬ 
tion of a particular file or directory. Since the full path name is 
actually the complete name of the file or directory, it ensures that 
no two directories (and no two files) on the system have exactly the 
same full name. To use the filing cabinet analogy again, you can 
locate a letter addressed to John Smith using its “path name,” by 
knowing it is in the second cabinet drawer, behind the divider 
marked “Boni Project,” in a folder marked “letters.” 

On DOS systems, path names and file names may be preceded by a 
drive name (also known as a device specifier). A device specifier is 
the same as the name of the disk drive you want to access, A: or 
B :, for example. UNIX path names and file names do not use drive 
names; the correct device is automatically accessed with the path 
name. 

There are two kinds of path names, a full path name and a relative 
path name. A full path name on DOS systems always begins with a 
backslash (\) and consists of the sequence of directories from the 
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root directory to the file or directory you wish to access. A rela¬ 
tive path name does not begin with a backslash. It describes the 
location of the target file or directory relative to your current loca¬ 
tion (current directory). 

A full path name consists of a backslash followed by one or more 
directory names separated by backslashes and ending with the name 
of the target file or directory. It may be preceded by a drive name, 
which tells the system on which device the desired file or directory is 
located. It is only necessary to use the drive name if you are not 
referring to the current drive. The backslash at the beginning of the 
path name tells the system to begin its search for the target from 
the root directory. (If it does not begin with a backslash, DOS 
begins at the user’s current directory.) For example, if the file that 
contains Tony’s eastern region August forecast is on the current 
drive, its full path name would be: 

\tony\east\forecast\august 

If his directory is on the A drive rather than the current drive, its 
full path name would be: 

a:\tony\east\forecast\august 

A relative path name omits all directory names and the drive name 
from the path name up to and including the current directory. It 
tells the system to begin the search for the target file or directory 
from the current directory. You can access a file in your current 
directory by using its relative path name. In this case, the relative 
path name consists of only the file name. Or, you can use the rela¬ 
tive path name to access a file in a subdirectory of your current 
directory by specifying the name of the subdirectory followed by a 
slash and the name of the file. For example, user Tony can list the 
contents of his july directory by using the relative path name with 
the dir command: 

VP/ix Z:\tony> dir forecast\july 

It is not necessary to use the full path name to the directory, 
\tony\forecast\july. 

When using DOS or VP/ix, you may not specify a path name con¬ 
taining more than 63 characters, including the initial backslash. If 
you need to specify a path name longer than 63 characters, change 
to a directory in that path, then specify the relative path name, lim¬ 
iting the path name to no more than 63 characters. 
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Because a directory is simply a special type of file, you cannot give 
a subdirectory the same name as another file in a directory; all files 
within a single directory must have a unique file name. 

Path Name Shortcuts: Dot and Dot Dot 

DOS provides shorthand notations to indicate the current directory 
and the directory one level above it. These shortcuts are available 
to help minimize typing. A single dot (.) indicates the current 
directory. Two dots (..) indicate the directory directly above the 
current directory. 

For example, you may use the dot with the copy command to copy 
all the files in the current directory to a subdirectory in that 
directory. 

VP/ix Z:\usr\tony> copy . tabs 

The “dot,” when used in place of a path name, indicates that the 
command should use all the files in the current directory. 

To list the files and directories in the directory just above your 
current directory, type: 

VP/ix Z:\usr\tony> dir . . 

To list the files in the directory two levels up from your current 
directory, type: 

VP/ix Z:\usr\tony> dir . .\. . 
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Creating Directories (mkdir.) 

The mkdir command is used to create subdirectories in which you 
can organize your files. 


COMMAND NAME 

mkdir or md 

FORMAT 

mkdir [drive: ] filename or pathname 
md [drive: ] filename or pathname 

DESCRIPTION 

Creates a directory with the name given. 

OPTIONS 

None. 

ARGUMENTS 

To create a directory on a drive other than the default 
drive, you must supply a drive name. To create a 
directory in your current directory, give a file name. 

To create a directory somewhere other than your 
current directory, give the path name. 


For example, to create a new directory named memos in your 
current directory, type: 

VP/ix Z:\usr\tony> mkdir memos 

After the DOS operating system runs this command, the new sub¬ 
directory, memos, exists in your current directory. You are not 
automatically moved to the new directory; you remain in your 
current directory. To verify that the directory was created, use the 
dir command to list the directory contents: 

VP/ix Z:\usr\tony> dir 

Your screen should look similar to this: 

MEMOS <DIR> 7-19-87 11:22a 

1 File(s) 2443575 bytes free 

You can create directories anywhere in the directory structure by 
using mkdir, followed by the path name of the directory you want 
to create. 
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Changing Directories (cd) 

To change to another directory, use the cd command. 
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COMMAND NAME 

cd or chdir 

FORMAT 

cd [drive:] [pathname] 
chdir [drive:] [pathname] 

DESCRIPTION 

Changes the current directory to another directory. 
Without an argument, cd prints the name of the 
current drive and the path name of the directory in 
which you are currently located. 

OPTIONS 

None. 

ARGUMENTS 

The drive name where the directory is located (if it 
is not on the current drive) and the path name of the 
directory to which you want to change. 


For example, to change from your current directory to the directory 
\tony on your current drive, type: 

VP/ix Z:\usr\bob> cd \tony 

followed by I RETURN! . If the directory \tony is not on the 
current drive, you must use the appropriate drive name as well. For 
example, cd a : \tony. 

Use cd without an argument to verify that your current directory is 
now \tony. Of course, in the VP/ix Environment, the prompt 
keeps you informed of the current directory. 

To change to the directory directly above your current directory, use 
the shortcut you learned previously: 


VP/ix Z:\usr\tony> cd . . 
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Deleting Directories (rmd i r) 

To delete a directory on a disk or diskette, use the DOS rmdir 
command. 


COMMAND NAME 

rmdir or rd 

FORMAT 

rmdir [ drive : ]pathname 


r d [ drive: ] pathname 

DESCRIPTION 

Removes the specified directory, if empty. 

OPTIONS 

None. 

ARGUMENTS 

The path name of the directory to be removed. 


The directory must be empty in order to be removed. If it is not 
empty, DOS returns the message directory not empty. This 
prevents you from accidentally deleting files and directories. 

For example, to remove the directory \tom\letters, first 
remove all the files in the directory by typing: 

VP/ix Z :\tom> del \tom\letters 

Since you do not give a specific file name to be removed, DOS 
assumes you want to delete all the files in the named directory. The 
DOS operating system asks: 

Are you sure (Y/N)? 

Type y. Then remove the directory itself by typing: 

VP/ix Z:\tom> rmdir \tom\letters 

If you are in the directory \tom, you can use the relative path 
name and simply type rmdir letters. 

You can delete any directory by specifying its full path name. To 
remove the \amy\sales_n directory on a diskette in drive A, 
make sure that it is empty, then type: 

VP/ix Z:\tom> rmdir a:\amy\sales_n 
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There is no single command in the DOS operating system that 
allows you to rename a directory. To rename a directory that has 
no subdirectories, do as follows. If you have a directory named 
\memos that you would like to rename memos_aug, create a 
new directory with the new name using mkdir: 

VP/ix Z:\usr\tony> mkdir \memos_aug 

Copy all files from the old directory to the new directory using 
copy: 

VP/ix Z:\usr\tony> copy \memos\*.* \memos_aug 

Next, delete the contents of the old directory, using del: 

VP/ix Z:\usr\tony> del \memos\*.* 

The system will issue the following prompt: 

Are you sure (Y/N)? 

Type y. Delete the old directory using rradir: 

VP/ix Z:\usr\tony> rmdir \memos 
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BASIC DOS COMMANDS 

This section presents some basic DOS commands used to perform 
necessary tasks on your files and diskettes. In this section you will 
learn: 

• How to copy DOS files. 

• How to delete DOS files. 

• How to rename DOS files. 

• How to display DOS files. 

• How to display DOS files one screen at a time. 

• How to find a particular string of text in files. 

• How to sort DOS files. 

• How to format a DOS diskette. 

• How to copy a DOS diskette. 

• How to check a DOS diskette for errors. 
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Use the copy command to copy one or more files. It will copy a 
file or files onto the same drive or onto another drive. 


COMMAND NAME 

copy 

FORMAT 

copy [ drive : 1 pathname [ drive : 1 [pathname 1 

DESCRIPTION 

Copies one or more files to another drive or to the 
same drive. 

OPTIONS 

Presented later in this primer. 

ARGUMENTS 

The source drive (the drive that has the file to be 
copied on it) and the target drive (the drive onto 
which you want to copy the files). 


To copy a file from a diskette in the current drive (A, for example) 
to the same diskette in drive A, use the command: 

VP/ix A : \usr\phi 1> copy a : john . ltr a : phi 1. ltr 

The copy command copies the file named john. ltr on the 
diskette in drive A to the file phi 1 .ltr on the diskette in drive A. 
Note that you do not have to use a drive letter when you designate 
the current drive. If the current drive is A, (the prompt is 
VP/ix A: \usr\phil>), you can make a copy of the file named 
john . ltr and call it phil. ltr by typing: 

VP/ix A:\usr\phi1> copy john.ltr phil.ltr 

To make an exact copy of a file from the diskette in drive A to the 
fixed disk (with A as the current drive), use the command: 

VP/ix A: \usr\phi 1> copy a : john .ltr z : john . ltr 

The copy command copies the file john. ltr on drive A to the 
file john. ltr on drive Z. Because drive A is the current drive, 
you could also type the following to accomplish the same task: 

VP/ix A:\usr\phi1> copy john.ltr z:john.ltr 

If you do not specify a file name for the copy, copy uses the name 
of the original file for the new file. For example, each of the follow¬ 
ing commands copies john .ltr to the current directory on the Z 
drive: 
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copy a : john. ltr z : john. ltr 
copy john.ltr z : john.ltr 
copy john. ltr z: 

The command: 

copy john. ltr z:\john.ltr 

copies john. ltr to the root directory of the UNIX file system, 
if that directory is writable. 

See the section entitled “Converting Text File Formats” for more 
information about transferring DOS and UNIX files. 

Deleting Files (del and erase) 

Use the del or erase commands to delete a file. 


COMMAND NAME 

del 


erase 

FORMAT 

del [ drive : ] pathname 
erase [ drive: ]pathname 

DESCRIPTION 

Deletes all files with the designated file specifica¬ 
tion. Wildcards are accepted; however, only one 
path name can be deleted at a time. 

OPTIONS 

None. 

ARGUMENTS 

A drive and a path name to the file or directory to 
be deleted. 


For example, to delete the file sales . txt from the current direc¬ 
tory on drive Z, use the command: 

VP/ix Z:\usr\tony> del sales.txt 

The file is permanently deleted from the fixed disk. 

You may also use wildcards when deleting files from a directory. 

K* r Be careful when you use the * . * abbreviation. Typing the 
command del * . * will cause the DOS operating system to 
delete all files in the current directory. 
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VP/ix Z:\usr\tony> del *.* 

DOS asks you to confirm that you want to delete the files: 

Are you sure (Y/N)? 

Type Y (yes) or N (no). 

Note that the del command does not work if you type the word 
delete. 


Renaming Files (rename) 

To change the name of a file, use the rename command. 


COMMAND NAME 

rename or ren 

FORMAT 

rename [drive:]pathname filename 
ren [drive:]pathname filename 

DESCRIPTION 

Renames files. 

OPTIONS 

None. 

ARGUMENTS 

If the file resides on a drive other than the default 
drive, you must supply a drive name. Any drive 
name to the filename option is invalid and 
produces an error message. You cannot rename files 
across drives. 


To change the name of a file on the fixed disk called memo . doc to 
billmemo. doc, type: 

VP/ix Z : \usr\tony> rename memo.doc billmemo.doc 

The file memo.doc no longer exists; an identical file called 
billmemo . doc is now on your fixed disk. 

mr You can use rename only on files on the same disk or 
diskette. That is, you cannot use drive letters to change 
a : memo . doc to b : memo . doc. 

To change the name of a file called story.doc on drive A to 
fable. doc, first make sure that the diskette containing 
story.doc is in drive A, then type this command: 





40 


VP/ix and MS-DOS Primer — Release 1.1.0 


VP/ix Z:\usr\tony> rename a: story, doc fable.doc 
The file is now named fable . doc. 

Displaying Files (type) 

To display the contents of a file on the screen, use the type 
command. 


COMMAND NAME 

type 

FORMAT 

type [ drive : ] [pathname ]filename 

DESCRIPTION 

Displays the contents of a UNIX or DOS text file 
on the screen. 

OPTIONS 

None. 

ARGUMENTS 

If the file resides on a drive other than the default 
drive, you must supply a drive name. You must 
supply a file name. 


To view the contents of the file named boats, cal in the current 
directory, type: 

VP/ix Z : \usr\tony> type boats . cal 

boats, cal is displayed on the screen. If the file is longer than a 
single screen, i t will c ontinue to scroll by quickly until you stop the 
scrolling. Use |CTRL| and type s to stop the scrolling. To continue 
displaying the text of the file, use i CTRL I and type q. Depending on 
the length of the file, you may have to do this several times if you 
wish to read the entire file. 

You can display both UNIX and DOS files using the type 
command. 

To display the contents of a file named deadline. 10 on a 
diskette in drive A, first make sure that the diskette with the file 
named deadline. 10 is inserted in drive A. If A is not the 
default drive, then change to the A drive. Either type: 

VP/ix Z:\usr\tony> a: 

VP/ix A:\> type deadline. 10 

or type: 
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VP/ix Z : \usr\tony> type a : deadl ine . 10 

followed by |RETURN] . The contents of deadline.10 is 
displayed on the screen. 

Program files (files with a file name extension of . com or . exe) 
yield only uninterpretable symbols when displayed using type. 
Because of the format differences between UNIX and DOS text files, 
the type command does not work very well on UNIX files. See 
the section entitled “DIFFERENCES BETWEEN DOS AND UNIX 
FILE SYSTEMS” for information on converting files from one for¬ 
mat to the other. 

DOS files created while running some application programs may 
require that you run the application program to view the contents of 
those files. They cannot be viewed using type. Refer to the 
material provided with your application program for more 
information. 

Displaying Files (more) 

The more command is similar to the type command, but sends 
its output to the console one screen at a time. 


COMMAND NAME 

more 

FORMAT 

more <[pathname]filename 

DESCRIPTION 

Sends output to the display one screen at a time 

This command takes its input from the keyboard. On 
displaying one screen of text, the more command 
pauses and displays the message - -More-- at the 
bottom of the screen. To display the next screen, 
use the RETURN key. This process continues until 
all the text has been displayed. 

OPTIONS 

None. 

ARGUMENTS 

None. 


more is useful for displaying the contents of files. To use more to 
display a file, you must use the input/output redirection symbol <. 
This is discussed in detail in “Redirecting Input and Output” in the 
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section entitled “ADVANCED DOS OPERATIONS.” To use more 
to display the text of a file named tom. txt, type: 

VP/ix Z:\usr\tom> more <tom. txt 

Because of the format differences between UNIX and DOS text files, 
the more command does not work very well on UNIX files. See 
the section entitled “DIFFERENCES BETWEEN DOS AND UNIX 
FILE SYSTEMS” for information on converting files from one for¬ 
mat to the other. 

Searching for Text (f i nd) 

The find command searches for a specific string of text in a file or 
files. 


COMMAND NAME 

f ind 

FORMAT 

find [/n] " string " [drive:][pathname] 

DESCRIPTION 

Searches for a specified string in the designated file 
name or names, and displays the line or lines containing 
the string. 

OPTIONS 

/n Displays each line found preceded by the 
relative line number. 

ARGUMENTS 

The string, surrounded by double quotes. Do not include 
a double quote as part of the search string. You can 
optionally specify the drive and path name of the file 
or files to be searched. 


For example, to search for the string Halloween in the file 
review. 10, type: 

VP/ix Z:Vusr\tony> find "Halloween" review.10 

This displays all lines from review. 10 that contain the string 
Halloween. 

As another example, to search for the string fool's paradise 
in the files bookl . txt and book2 . txt, type: 

VP/ix Z : \usr\tony> find "fool's paradise" bookl . txt book2 . txt 
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This displays all lines from bookl.txt and book2.txt, in 
that order, that contain the string fool's paradise. 

^ Note that unlike most DOS commands, find is case-sensitive 
with regard to the search string. 

Sorting Files (sort) 


The sort command is used to sort data alphabetically, in either 
ascending or descending order. 


COMMAND NAME 

sort 

FORMAT 

sort [/r] [drive: ][pathname] 

DESCRIPTION 

Reads standard input, sorts the data, then writes the 
sorted data out. 

OPTIONS 

/r Sort in reverse order, starting with the letter Z. 

ARGUMENTS 

The drive and path name of the file to be sorted. 
Otherwise, sort takes input from the keyboard as 
the data to be sorted. 


For example, to alphabetically sort names as you type them in at 
the terminal, type: 

VP/ix Z:\usr\tony> sort 

followed by I RETURN I . 

The sort command is generally used to sort data already in files. 
For an example of this, see “Using Filters” in the section entitled 
“ADVANCED DOS OPERATIONS”. 

Formatting Diskettes (format) 

You must “format” all new diskettes before they can be used by 
DOS. Formatting checks the diskette for defects and makes the 
diskette usable by DOS. To format a diskette, use the format 
command. Diskettes need to be formatted only once, the first time 
they are used. Diskettes formatted by a UNIX utility do not need 
reformatting with a DOS utility, and vice versa. 
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Note, however, that the format command destroys any infor¬ 
mation that is on a diskette. 


COMMAND NAME 

format 

FORMAT 

format [drive:] [/4] 

DESCRIPTION 

Prepares the diskette in the specified drive to 
accept DOS files. 

OPTIONS 

/4 Format diskette double-sided, double-density 
(the default is to format it as a high-density 
diskette) 

ARGUMENTS 

The drive in which the diskette to be formatted is 
located. If no drive is specified, the default drive 
is used. 


To format a blank diskette, first make sure that you are using the 
DOS system (that is, you have logged in and at the UNIX prompt, 
you have typed vpix). To format a high-density diskette, type: 

VP/ix Z:\usr\tony> format a: 

Your screen will look similar to this: 

Insert new diskette for drive A 
and strike ENTER when ready 

Insert a diskette in drive A and use I RETURN! . 

When formatting is complete, DOS asks: 

Format another? (Y/N) 

Type N (no) or Y (yes) and use I RETURN] . 

To format a double-sided, double-density diskette in drive A, type: 
VP/ix Z:\usr\tony> format a:/4 

ttr Use the format command on diskettes only. Although the 
format command is sometimes used to format fixed disks on 
standard DOS systems, it should not be used for that purpose in 
the VP/ix Environment. 
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The diskcopy command is used to copy the contents of diskettes. 
To copy a diskette using diskcopy, you must have: 

• The diskette you want to copy. 

• A diskette to copy it to. (If the diskette is not blank, any exist¬ 
ing data will be destroyed; it will be overwritten by the contents 
of the diskette you are copying.) 


COMMAND NAME 

diskcopy 

FORMAT 

diskcopy [source drive : 1 [target drive : 1 

DESCRIPTION 

Copies the contents of the diskette in the first 
specified drive (the source drive) to the diskette in 
the second specified drive (the target drive). j 

OPTIONS 

Not presented in this document. 

ARGUMENTS 

A source drive, containing the diskette with the files 
to be copied, and a target drive, containing the 
diskette on which the files are to be copied. If you 
give only one drive name as an argument, it is used as 
both the source and target drive. You are prompted | 
to remove the first diskette and insert the second one. 


To copy the contents of a diskette from drive A to drive B, first put 
the diskette you want to copy into drive A. Put another diskette 
into drive B. (The diskette does not need to be formatted because 
the diskcopy command will automatically format it during the 
command process.) Type: 

VP/ix Z:\usr\tony> diskcopy a: b: 
and use | RETURN] . Your screen will look similar to this: 

Insert SOURCE diskette in drive A: 

Insert TARGET diskette in drive B: 

Press any key when ready . . . 

Since you have already placed the diskettes in the proper drives, you 
can press any key to start the diskcopy program. When the disk 
has been copied, the DOS system asks: 
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Copy another? (Y/N) 

Type N to exit the diskcopy program or Y to copy another 
diskette. 

If you have only one diskette drive, give that drive name only once 
as an argument: 

VP/ix Z: \usr\tony> diskcopy a: 

DOS will prompt you at the appropriate time to remove the diskette 
you wish to copy and insert the blank, formatted diskette. 

ttr Use the diskcopy command on diskettes only. It is not 
intended for use on fixed disks. 

Checking Diskettes (chkdsk) 

The DOS chkdsk command is used to check diskettes for con¬ 
sistency and errors, much like a secretary proofreading a letter. 
The chkdsk command analyzes the specified diskette and pro¬ 
duces a status report of any problems, such as files that have a non¬ 
zero size in the directory but really have no data in them. You 
should run chkdsk occasionally on each diskette to make sure the 
files on it are not corrupted. 

You cannot use the chkdsk command on the Z drive because 
the Z drive is not a DOS file system and it is not on a diskette; 
the Z drive contains the UNIX file system on the fixed disk. 


COMMAND NAME 

chkdsk 

FORMAT 

chkdsk l/f] [drive:] [ pathname] 

DESCRIPTION 

Scans the diskette in the specified drive and checks 
it for errors. 

OPTIONS 

/f Correct any errors found in the directory. 

ARGUMENTS 

The drive that contains the diskette with the files to be 
copied. A path name; if a path name is specified, then 
the DOS operating system displays a status report for 
the diskette and for the specified file. 


To check the diskette in drive A, type: 
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VP/ix Z:\usr\tony> chkdsk a: 

This displays a status report and any errors that chkdsk has 
found: 

Volume DOSDISK create July 12, 1987 3:21p 

362496 bytes total disk space 

38912 bytes in 2 hidden files 

1024 bytes in 2 directories 

282624 bytes in 42 user files 

39936 bytes available on disk 

524288 bytes total memory 

487248 bytes free 
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DIFFERENCES BETWEEN DOS AND UNIX 
FILE SYSTEMS 

This section discusses the differences between the DOS and UNIX 
file systems. In this section you will learn: 

• How permissions apply to the Z drive. 

• How to determine the permissions of files and directories on the 
Z drive. 

• How to determine the real name of UNIX files with illegal DOS 
names. 

• How to copy text files from DOS format to UNIX format and 
from UNIX format to DOS format. 

• How to change path name and option conventions from DOS for¬ 
mat to UNIX format and from UNIX format to DOS format. 

The directory structures of the DOS and UNIX systems are similar. 
Both store data in a collection of files and directories that are 
arranged in a hierarchical order. However, it is not possible to 
access files in a UNIX file system from native DOS or files in a DOS 
file system with standard UNIX. The formats of UNIX and DOS 
files are somewhat different. Certain UNIX programs that are not 
part of the VP/ix Environment, such as cpio and tar, use 
different strategies for storing data on diskettes. Disks created using 
these programs cannot be used by the DOS system. The path name 
conventions for the two operating systems are also different. 

The VP/ix Environment supports many features that make DOS and 
UNIX files and path names compatible. The VP/ix Environment 
provides: 

• Access to the UNIX file system while in the VP/ix Environment. 

• Utilities to convert DOS text files to a UNIX format. 

• Utilities to convert UNIX text files to a DOS format. 

• Utilities to change DOS-style path name and option conventions 
to UNIX-style conventions. 

• Utilities to change UNIX-style path name and option conventions 
to DOS-style conventions. 
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The Z Drive 

The Z drive, as implemented by the VP/ix Environment, enables 
you to access the UNIX file system while running DOS. The UNIX 
file system, when accessed through the Z drive, behaves exactly like 
a native DOS file system. You can use standard DOS commands 
and editors (such as mkdir or edlin) to manipulate all of the 
files in the UNIX file system. You may also use any UNIX file with 
DOS applications and install your DOS applications on the UNIX 
file system. 

In many 386 configurations there are no true DOS file systems avail¬ 
able on the computer. If this is the case on your computer, the files 
you wish to create and access while in the VP/ix Environment 
should either be on diskettes (in drive A or B) or on the Z drive. 
Ask your system administrator if drives other than the Z drive are 
available on your fixed disk. Regardless of the availability of other 
drives, files placed on the Z drive are more versatile because they 
are available to you and to others when you are at the UNIX 
prompt running UNIX commands. 

The Z drive is the default drive in the VP/ix Environment. When 
you type vpix at the UNIX prompt, you are automatically placed 
in the Z drive. Your prompt will look similar to this: 

VP/ix Z:\usr\tony> 

Your current directory is the same UNIX directory from which you 
started the VP/ix Environment. While on the Z drive, you can 
access any file or directory that is stored under the UNIX file 
system. 

Each time you change from one drive to another in the VP/ix 
Environment, you are placed in the directory you accessed last on 
that drive. When you access the Z drive, VP/ix places you in the 
last directory you accessed on the Z drive under UNIX or DOS. For 
example, if you started the VP/ix Environment from the UNIX 
directory /usr/tony, the system places you in z : \usr\tony: 

VP/ix Z:\usr\tony> 

If you then access another drive (the A drive, for example) and 
return to the Z drive, you will be returned to the directory 
z : \usr\tony. 
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File Access Permissions 

The UNIX system is a multi-user file system. This means that mul¬ 
tiple users have access to the files and directories that are stored on 
the computer. To prevent unauthorized users from accessing data 
on the system, a set of file access permissions (also known as “pro¬ 
tection modes”) is assigned to each file and directory on the system. 
In addition, each file and directory is assigned an owner (user) and 
a group identification number. File and directories are usually 
owned by the user who created them and are assigned the same 
group ID number as the user. 

Because the VP/ix Environment runs in a multi-user environment 
and provides access to the UNIX file system through the Z drive, it 
must also support file access permissions. The file access permis¬ 
sions determine who can access a given file on the Z drive. File 
access permissions are not assigned to files on any other DOS disk 
drive (A, B, or C) because they are DOS file systems. Each file and 
directory on the Z drive has two protection modes, read (r) and 
write (w), associated with it. 

Read permission 

Allows a user to view the contents of the file or copy it 
to another area. Read permission by itself does not 
allow a user to change a file. 

Write permission 

Allows a user to make changes to a file. Write permis¬ 
sion on a directory allows a user to create and delete 
files in that directory. 

The protection modes are assigned to three categories of users: user, 
group, and other. The “user” of the file owns the file or directory. 
The “group” often consists of people working on the same project or 
in the same department who may need to use the same files. Group 
membership is usually determined by the system administrator. 
“Other” refers to everyone on the system who is neither the user nor 
in the user’s group. 

When a file or directory is created on the Z drive, it is automati¬ 
cally assigned default permissions. These are as follows: 
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User Category 

Permissions 

User 

read, write 

Group 

read 

Other 

read 


To change the permissions of files on the Z drive, the UNIX com¬ 
mand chmod must be used. See the “UNIX Primer” in the 386/ix 
Operating System Guide for information on how to use chmod. 

Determining UNIX File Information (xdir) 

The VP/ix Environment command xdir is used to display file 
access permissions for files on the Z drive, as well as their user and 
group ID numbers. It also displays the actual UNIX names of files. 
If you have given a file a name that is invalid in the DOS operating 
system, xdir can be used to determine its true name. It is other¬ 
wise identical to the DOS command dir. 


COMMAND NAME 

xdir 

FORMAT 

xdir z .[pathname] 

DESCRIPTION 

Displays information about the files and directories 
in the specified drive and directory. If no path name 
is specified, lists all files and directories in the current 
directory on the current drive. Information 
includes file name, type, creation date and time, 
access permissions, and size. 

OPTIONS 

None. 

ARGUMENTS 

The z : drive and a path name to a file or a directory. 


If you are not on the Z drive, you can type: 

VP/ix A: \tony> xdir z : \usr\bob 
to get a listing of the files in \usr\bob. 

If you are already on the Z drive and in the directory you want to 
list, type: 

VP/ix Z:\usr\bob> xdir 
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Your screen will look similar to this: 


Volume in drive Z is UNIX 
Directory of Z:\usr\bob 



<DIR> 

8/05/87 

12:48p 


[rwr-r-] 

<200,3> 


<DIR> 

8/05/87 

12:46p 


[rwr-r-] 

<200,0 > 

~ PROF ~AA 

150 

8/05/87 

12:00a 

.profile 

[rw-] 

<200,3> 

VPIX 

<DIR> 

8/05/87 

12:46p 

vpix 

[rwrwrw] 

<200,3> 

REPORT 

1107 

8/05/87 

12:47p 

report 

[rwrwr-] 

<200,3> 


5 File(s) 33553920 bytes free 


Each line contains the standard DOS information, as well as the 
additional UNIX information. The file’s read and write permissions 
for the user, group, and others are displayed within square brackets. 
The UNIX user and group ID numbers are displayed in the last 
column in angle brackets (< >). The true UNIX names of the files 
are shown. The name of the file ~PROF~AA is really . profile. 

The permissions for the file named REPORT are as follows: 

File Access Permissions 


rw rw r- 

t t t 

User Group Other 


The first two columns specify the read (r) and write (w) permis¬ 
sions for the user. In this case, the user can read and modify the 
file. The next two columns specify the permissions set for the user’s 
group. The permissions indicate that members of the group can 
read and write the file. The last two columns specify permissions 
for others on the system. Others are allowed to read the file but 
cannot modify it. A dash indicates that a permission is denied. 

Converting Text File Formats 

Text files are stored differently under the DOS and UNIX systems. 
The UNIX system uses the new-line character to specify the end 
of a line; DOS uses a carriage-return followed by a new- 
line to specify the end of a line. Because of this, DOS files 
viewed through a UNIX editor display control characters at the end 
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of each line, and UNIX text files are improperly displayed by many 
DOS utilities and applications. 

You can use the DOS copy command with its special VP/ix 
options to copy a text file from DOS format to UNIX format and 
from UNIX format to DOS format. 


COMMAND NAME 

copy 

FORMAT 

copy [/d /u ] [ drive: ]pathname [ drive: ][pathname ] 

DESCRIPTION 

Copies one or more files to another disk or to the 
same disk. 

OPTIONS 

/d Copies a UNIX-format text file into DOS format. 

/u Copies a DOS-format text file into UNIX format. 

ARGUMENTS 

The source drive (the drive containing the diskette that 
has the files to be copied on it) and the target drive (the 
drive that contains the diskette onto which you want 
to copy the files). 


To copy a UNIX-format text file to DOS format, use the /d option. 
For example, if the current drive is A, use the following command 
to copy the file called unix.doc to drive B:, converting the 
UNIX file format to DOS file format: 

VP/ix A:\> copy unix.doc b: /d 

To copy a DOS text file to UNIX format, use the /u option. For 
example, to copy the file called msdos . doc to unix . doc, con¬ 
verting the DOS file format to UNIX file format, type: 

VP/ix A: \> copy msdos . doc unix . doc /u 

There is also a UNIX utility called lef that can convert DOS files 
to UNIX format and UNIX files to DOS format. It is useful if you 
wish to use a DOS editor to edit a UNIX file or vice versa. It is nor¬ 
mally run from the UNIX prompt, but it can be run in the VP/ix 
Environment as well. 
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Use the lef command to change either UNIX files to DOS format 
or DOS files to UNIX format, lef automatically determines the 
current format of the file and changes it to the opposite format. 


COMMAND NAME 

lef 

FORMAT 

lef pathname pathname 

DESCRIPTION 

Determines the current format of the specified text file 
(either DOS or UNIX) and converts to the other format. 

OPTIONS 

None. 

ARGUMENTS 

lef accepts zero, one, or two arguments. If no 
argument is specified, lef takes its input from 
the keyboard and sends its output to the terminal 
screen. If one argument is specified, it is assumed 
to be the input file and the output is sent to the 
terminal screen. If two arguments are specified, 
the first is the input file and the second is the 
output file. 


For example, to change a file named report to the other file for¬ 
mat, type: 

VP/ix Z:\tony> lef report reportl 

Transferring Files Between UNIX and DOS 

Other utilities are available for transferring files across file systems. 
Standard UNIX utilities, such as the cp and mv commands, can be 
used to copy DOS files on the Z drive just as if they were UNIX 
files. 

Changing UNIX and DOS Conventions 

The syntax used to separate path names and to indicate options in 
DOS is different from that used on the UNIX system. When you 
enter the VP/ix Environment, the DOS path name separation char¬ 
acter (\) and option character (/) are in effect, rather than the 
equivalent UNIX characters (/ and -, respectively). 

If you are more comfortable using the UNIX system and want to 
have the VP/ix Environment accept and display only the UNIX 
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conventions, use the VP/ix utility unixpath. Once you invoke 
unixpath, even the VP/ix prompt immediately changes from 
VP/ix C : \> to VP/ix C : />. 


COMMAND NAME 

unixpath 

FORMAT 

unixpath 

DESCRIPTION 

Causes the system to use UNIX-style option 
characters (-) and path name separators (/). 

OPTIONS 

None 

ARGUMENTS 

None 


If you want to return to the DOS-style characters after you have 
invoked unixpath, use the utility dospath. 


COMMAND NAME 

dospath 

FORMAT 

dospath 

DESCRIPTION 

Causes the system to use DOS-style option 
characters (/) and path name separators (\). 

OPTIONS 

None 

ARGUMENTS 

None 


It makes no difference whether you access files in a DOS file system 
(on the A drive, for example) or the UNIX file system on the Z 
drive; the VP/ix Environment lets you use one consistent set of char¬ 
acters, either UNIX-style or DOS-style. 
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ADVANCED DOS OPERATIONS 

This section describes advanced DOS commands. In this section you 
will learn: 

• The difference between internal and external commands. 

• How to set a search path. 

• How to redirect input and output. 

• What a filter is. 

• What a pipe is. 

Loading DOS Applications 

DOS applications are loaded onto the Z drive of your fixed disk 
under the VP/ix Environment exactly as they are loaded onto your 
fixed disk under native DOS. The loading procedure depends 
directly on the application. To find out how to load a particular 
application onto your fixed disk, refer to the documentation that 
accompanied the application. If you are asked for a drive name 
during the procedure, use Z rather than C, because the C drive 
should only be used for booting the VP/ix Environment. 

Internal and External Commands 

DOS and UNIX programs are files that are located on either the 
fixed disk or a diskette. When you invoke a command (vpix, for 
example), the system must locate the command before it can exe¬ 
cute the command. DOS stores its commands in two ways. They 
are either stored as internal commands or as external commands. 

An internal command is a program that is always resident in 
memory. The internal commands del, mkdir, cd, copy, and 
type, for example, are listed in the file command . com. The sys¬ 
tem reads command. com when you initially boot DOS, and all of 
the commands listed there are automatically loaded into memory. 
Commands loaded into memory execute faster than commands that 
do not reside in memory. 

External commands are all the other commands that are not 
resident in memory. They can be stored in any directory on a fixed 
disk or diskette and must have a file name extension of either com 
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(command), exe (execute), or bat (batch), separated from the file 
name by a period, diskcopy, format, and chkdisk are 
examples of external commands. Each has the file name extension 
com. However, when you invoke the command, you do not need to 
type the file name extension. Because external commands are files, 
you can create commands and add them to your DOS system; these 
should be given the file name extention exe or com. 

External commands take longer to execute than internal commands 
because they must be located by the system via a search path, read, 
and then executed. By default, the system searches the current 
directory when a command is issued. If the command is not there, 
the system displays an error message. Unless the commands are 
located in your current directory, DOS does not know where to find 
them. You must use the path command to explicitly tell the DOS 
system the name(s) of the directory or directories that contain your 
external commands. The system automatically searches each of the 
of the directories listed, in order, for the command that is invoked. 

Setting a Search Path (path) 

Use the path command to set a search path to locate external 
commands. 


COMMAND NAME 

path 

FORMAT 

path [ drive: ] [pathname ] ; [ drive: ] [pathname ]... 

DESCRIPTION 

Sets a command search path. Specifying path 
with no argument causes the system to display the 
current search path. 

OPTIONS 

None. 

ARGUMENTS 

The drive(s) and path name(s) to a directory or 
directories containing external commands. 


For example, if you need an external DOS command such as 
format, located in \bin, you must tell the DOS operating system 
to look in the \bin path to find it. If you type: 


path \bin 
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DOS searches in your current directory and the \bin directory for 
all commands invoked thereafter. To specify more than one path, 
separate them with semicolons (;). For example, type: 

path \bin; \usr\tony\bin 

This sets the search path to include the directories \bin and 
\usr\tony\bin. After a path is set, the system looks for com¬ 
mands in your current directory. If it does not locate the command 
in your current directory, it searches \bin. If it does not locate 
the command in \bin, it looks in \usr\tony\bin. If the 
command is not found in any of the three directories, the system 
returns the error message Bad command or file name. 

When you are working with several directories, it is a good idea to 
put all DOS external commands into one separate directory so that 
you need only include one path name in your path command. 
This practice speeds up command execution, since only one direc¬ 
tory needs to be searched. 

All VP/ix users may execute path as a command at the DOS 
prompt. When you type the command path \bin at the DOS 
prompt, your path will be set to \bin for the duration of your 
current login session only. When you log out, this search path is no 
longer in effect. 

You can permanently set a new search path by modifying a special 
file called autoexec.bat. This special DOS file is used to set 
variables and to establish a set of login parameters. It is a batch 
file that is located in the root directory of the drive from which 
DOS is booted (started). A batch file is a DOS file that contains one 
or more commands that are executed sequentially when the file is 
invoked. In the case of autoexec . bat, it is automatically read 
and executed when the DOS system is booted. DOS is normally 
booted from the C drive, autoexec.bat can also be used to 
install programs that remain in memory, autoexec . bat can be 
modified using an editor (such as edlin on the DOS system or e 
or ed on the UNIX system). It is typically located on the C drive. 
If you cannot edit your copy of autoexec.bat, consult your 
system administrator. 

To display your current path, type the path command without any 
arguments at the system prompt. If no search path has been set, 
this returns the message No path. 
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When a VP/ix account is created, a default path is assigned. When 
initiating a VP/ix session, the system invokes the autoexec.bat 
file, which contains the path command. If you type path 
immediately after entering VP/ix, your screen will look similar to 
this: 

PATH=Z:\USR\VPIX\DOSBIN;Y:WPIXMJNIXBIN; Z:\USR\VPIX\UNIXBIN 

Y: is your home directory on the Z drive and \vpix\unixbin 
is a special directory for storing your own collection of UNIX com¬ 
mands. Z: is the Z drive, which holds the UNIX file system, 
\usr\vpix\dosbin is where all DOS commands are located, 
and \usr\vpix\unixbin stores UNIX programs that can be 
executed from the VP/ix Environment. 

If you plan to use your own DOS or UNIX commands, it is most 
convenient to place the UNIX commands in the directory 
\vpix\unixbin under your home directory, since it is already 
part of your default search path. However, you can create a new 
directory for them and add that directory to your search path, as 
explained previously. 

Redirecting Input and Output 

Every command to the computer requires input and produces out¬ 
put. DOS commands take their input from the standard input and 
direct it to the standard output. The standard input is taken from 
your ter minal keyb oard. For example, when you type a command 
and use I RETURN] , you are sending standard input to the system. 
The standard output for most DOS commands is to the terminal 
screen. When you type the dir command, for example, the stan¬ 
dard input is taken from your terminal keyboard and the standard 
output is written to the terminal screen. 

You can change the flow of command input and output by directing 
a command to take its input from a source other than its standard 
input and to send its output to a destination other than its standard 
output. For example, you can direct a command to take its input 
from a file already stored on the computer and to direct its output 
to another file or to a device such as a printer. The ability to take 
input from one place and direct it to another at the time you start a 
process is called redirection of input/output (I/O). Input can come 
from a file rather than a keyboard, and output can go to a file or to 
a line printer instead of to the screen. 
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Two symbols are used to indicate I/O redirection. The “greater 
than” (>) symbol redirects output, and the “less than” symbol (<) 
redirects input. 

Most commands produce output that is sent to your terminal screen. 
You can send this information to a file instead by following your 
command with a greater than symbol (>) and a file name. For 
example, the dir command displays the directory listing of the 
default drive on the screen. You can use the same command and 
redirect its output to a file named newf i le with the command: 

VP/ix Z : \usr\tony> dir >newfile 

You will not see any output on your screen. It is placed in the file 
newf i 1 e instead. 

mt~ When redirecting output, you must be careful not to use an 
existing file name as your output destination. You can 
overwrite the contents of the existing file if the file’s permis¬ 
sions allow it, thereby losing all the text or data in it. 

If the file newfile does not exist, the DOS operating system 
creates it and stores your directory listing in it. If newfile 
already exists, the DOS operating system replaces whatever is in the 
file with the directory listing. If the output file name is a device, 
such as LPT 1 :, the output will be redirected to that device. 

To redirect the output of a command and store the results at the 
end of a file that already exists without overwriting the contents of 
the file, use two greater than (>>) symbols. This appends the out¬ 
put of the command to the end of the file you specify. For example, 
to add the current directory listing to an existing file called 
tracking, type: 

VP/ix Z:\usr\tony> dir >>tracking 

It is often useful to have input for a command come from a file 
rather than from a terminal. Use the less than symbol (<) to 
redirect the input from a file. For example, to display the contents 
of a file named guests one screen at a time, type: 

VP/ix Z:\usr\tony> more <guests 


Using Filters 

A filter is a program that accepts input from one source, performs 
the appointed task on the data, and then writes the results to 
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another place without changing the input file in any way. The data 
is “filtered” by the program. Since filters can be put together in 
many different ways, a few filters can take the place of many 
specific commands. Examples of DOS filters include the commands 
find, more, and sort. 

For example, to sort a file called east. emp and redirect the out¬ 
put to a new file called eastemp . srt, type: 

VP/ix Z:\> sort <east.emp > eastemp. srt 

You have directed sort to take the file east. emp as its input by 
using the < symbol and to place the sorted output in a file called 
eastemp. srt by using the > symbol. 

Using Pipes 

A pipe is a connection between two or more commands. To create 
a pipeline, you execute a command and pass its output (“pipe” its 
output) so that it becomes the input for the next command. A pipe 
is indicated by typing the vertical bar symbol (!). While using 
DOS, you must have write permission in your current directory in 
order to pipe commands. 

Two filters are often used to create a pipeline. The output of a 
pipeline can be displayed on the screen, or it may be redirected to a 
file. For example, sometimes you may want the output of one pro¬ 
gram to become the input for another program. You can use sort 
and more together in a pipe. For example, type: 

VP/ix C:\> sort <mars.txt ! more 

This causes the system to sort the file mars.txt and to display it 
on your terminal one screen at a time. 

Another useful pipe involves programs that produce output in 
columns, such as dir. If you want to have these columns sorted 
alphabetically, type: 

dir ! sort 
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USING DOS AND UNIX COMMANDS TOGETHER 

The VP/ix Environment eliminates the boundaries between the DOS 
and UNIX operating systems. In this section, you will learn: 

• How to run DOS commands from the UNIX prompt. 

• How to run DOS applications from the UNIX prompt. 

• How to invoke the UNIX shell using the VP/ix Interface Menu. 

• How to run UNIX commands from the DOS prompt. 

• How to use DOS and UNIX commands together on the same line 
by using pipes and filters. 

Running DOS Commands From the UNIX Prompt 

It is not necessary to run the vpix command each time you want 
to run a DOS command or application. If you prefer to work in the 
UNIX environment, you may run DOS commands or applications 
that are stored on your fixed disk by simply typing the standard 
DOS command sequence. For example, at the UNIX prompt, you 
may type: 

$ dir 

The system displays a directory listing of your current directory and 
returns you to the UNIX prompt. All DOS commands, even when 
run from a UNIX prompt, follow standard DOS conventions. That 
is, you must use the slash character (/) to indicate options and the 
backslash (\) as the separator in path names. 

Users running DOS commands directly from the UNIX shell should 
note that certain special characters (such as the DOS wildcard char¬ 
acters * and ?, the DOS file separator \, and the DOS switch char¬ 
acter /) are interpreted by the UNIX shell. In these cases the sys¬ 
tem may behave in an unexpected manner. 

To avoid this problem, enclose arguments to DOS commands in sin¬ 
gle quotes (') when running them from the UNIX shell. For exam¬ 
ple, to run the dir command with the /w option on the directory 
sys on the first diskette, type: 

$ dir ' /w A: \sys ' 
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Running DOS Applications From the UNIX Prompt 

Before you run a DOS application, read the user documentation 
shipped with the software and be prepared to follow its instructions. 
For example, 1-2-3® requires that your current directory contain all 
1-2-3 system files. This is required no matter whether you run 
1-2-3 under native DOS, in the VP/ix Environment, or at the UNIX 
shell prompt. Thus, if you want to run 1-2-3 at the UNIX shell 
prompt, go to the directory where 1-2-3 is installed. 

To run a DOS application at the UNIX prompt, type the name of 
the DOS application. 

i tr Note that the application must be installed on the fixed disk; 
you cannot run DOS applications that are stored on diskettes 
from the UNIX prompt. 

The VP/ix Environment is automatically invoked when you access a 
DOS application. The VP/ix Interface Menu is also available. To 
access the VP/ix Interface Menu while running a DOS application, 
use ISYS-REOi . 

If you are unable to run DOS applications directly from the UNIX 
prompt, consult your system administrator or “VP/ix Maintenance 
Procedures” in this guide. Your VP/ix system may be incorrectly 
configured. 

When you are finished using a DOS application, follow the instruc¬ 
tions provided with the program to exit the application. The system 
will return you to the UNIX prompt. 

Invoking the UNIX Shell From the VP/ix Interface Menu 

You can run UNIX commands from the VP/ix prompt by accessing 
the VP/ix menu and selecting the option (E)nter shell. The 
system refreshes (clears) the screen and displays the UNIX prompt. 
Your VP/ix session is temporarily suspended. Whe n you are 
finished using UNIX commands, exit the shell by using | CTRL I and 
typing d. The screen refreshes and your VP/ix session is resumed. 
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Running UNIX Commands from the DOS Prompt 

All of the standard UNIX commands, namely those that reside in 
the directories /bin and /usr/bin on the UNIX file system, are 
automatically available in the VP/ix Environment. Simply type the 
UNIX command. For example, type: 

VP/ix z: \> who 

The UNIX who command produces a list of the users currently 
logged into your system, and the DOS prompt is redisplayed. 

All UNIX commands run from DOS must be issued in the UNIX 
format. That is, options on the command line must be preceded by 
a dash (-) rather than the DOS convention slash (/) and path 
names must use the slash (/) as a separator rather than the DOS 
separator character, backslash (\). For example, to obtain a long 
UNIX-style listing of the directory /usr/lib in the UNIX file 
system, type: 

VP/ix Z :\> Is -1 /usr/lib 

Note that a UNIX command run in the VP/ix Environment is not 
able to access files stored on DOS drives A, B, and C. Only files 
located on the Z drive, i.e., in the standard UNIX file system, can be 
used as arguments. 

Using Pipes With Both UNIX and DOS Commands 

When you run a DOS command at the UNIX shell prompt, you can 
pipe its output to a UNIX command; you can also pipe the output of 
a UNIX command into a DOS command. For example, if you type 
the following from the UNIX shell prompt: 

$ dir ! wc 

the DOS dir command runs and its output is piped to the UNIX 
wc command. (The wc command counts the number of lines, 
words, and characters output by dir and displays the result.) As 
another example, type: 
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filel, file2, and file3 are displayed sequentially by the 
UNIX command cat and the resulting output is displayed on the 
terminal one screen at a time by the DOS command more. This 
ability facilitates the integration of the DOS and UNIX environ¬ 
ments. In most cases, you do not have to think about whether you 
are running a DOS command or a UNIX command. 
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CONFIGURING THE VP/ix ENVIRONMENT 

The VP/ix Environment is installed with a default configuration. It 
can be tailored to support a different configuration on a system-wide 
or individual basis. You may need to tailor your system if you plan 
to use the diskette drive, a mouse, or if you want to run new pro¬ 
grams. The VP/ix Environment is customized by modifying: 

• The DOS file named autoexec . bat on the C drive. 

• The VP/ix configuration file (vpix. cnf). 

Depending on your requirements, you may modify one or both of 
these files. 

This section contains a brief overview of each file and explains why 
you would want to tailor your environment. Since VP/ix is a multi¬ 
user system, you should consult with your system administrator if 
you find that you need access to resources other than those assigned 
to you. Your system administrator can help you tailor your environ¬ 
ment so that there are no resource conflicts with other users. 


The autoexec . bat File 

This special DOS file will execute commands and programs that 
tailor a user’s and program’s environment. It is a batch file that is 
located in the root directory of the drive from which DOS is 
booted (started). A batch file is a DOS file that contains one or 
more commands that are automatically executed sequentially when 
the file is invoked, autoexec . bat is a special batch file because 
it is invoked immediately when the DOS system is booted. It is used 
for setting the path variable discussed in the section entitled 
“ADVANCED DOS OPERATIONS.” The autoexec.bat file 
allows you to execute programs automatically when you start a 
VP/ix session. For example, if you want to run WordPerfect® every 
time you boot the DOS system, your autoexec.bat file would 
look similar to this: 

cd wp 

wp 

You are placed in the WordPerfect program as soon as DOS has 
booted, rather than getting the DOS prompt. 
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You may have a personal autoexec.bat file only if you also 
have a personal copy of the bootable DOS image on your C drive. 
This consists of all the files and programs necessary to boot DOS, 
including autoexec.bat. The files and programs needed to 
boot DOS require a considerable amount of disk space. Your sys¬ 
tem administrator can provide you with your own copy of the boot¬ 
able DOS image if your system space permits. 


The YP/ix Configuration File 


The VP/ix configuration file enables you to access hardware devices 
such as diskette drives, the fixed disk, communication ports, printers, 
and a mouse pointing device. If you attempt to use a device and the 
system responds with an error message, your system is probably not 
configured to allow you access to it. 

Each time you access the VP/ix Environment, the VP/ix 
configuration file is read. If your system administrator has properly 
installed you as a VP/ix user, you will have your own version of the 
VP/ix configuration file named $HOME/vpix/vpix. cnf. 
$HOME is your login directory. Alternatively, if you are very fami¬ 
liar with the UNIX shell, you may designate a different path name 
for the vpix . cnf file by setting a shell variable called VPIXCNF 
in your .profile to be the name of your VP/ix configuration file. 

A typical configuration file looks similar to this: 

; VP/ix Configuration File 
; Lines beginning with ";" are comments 

; DOS device or UNIX device path name or 

; VP/ix auxiliary file VP/ix auxiliary file name 


A 

C 

COM 1 

LPT 1 

MOUSE 

ROM 

EGAROM 

CMOS 

BOOTIMAGE 


/dev/rdsk/f 0d9dt 
$HOME/vpix/C: 

/dev/ttyOO 

/bin/lp 

/dev/mouse 

/usr/vpix/defaults/rom 
/usr/vpix/defaults/romega 
/usr/vpix/defaults/cmos 
$HOME/vpix/vpix.img 


There are two types of entries in this file. A comment line begins 
with a semicolon (;). When the system reads the configuration file, 
all lines that begin with a semicolon are ignored. They are placed 
in the file to assist users by providing information and example 
entries. In most cases, all you will need to do to change 
vpix . cnf is to remove the appropriate semicolon. 
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Entries that do not begin with a semicolon are device assignments. 
A keyword or letter such as MOUSE or A is followed by the UNIX 
device name. A device name is the location of the software that is 
required to run the specific device, such as the diskette drive or the 
mouse. 

For example, to make a 360 KB diskette drive available, remove the 
semicolon on this line with a UNIX editor at the UNIX prompt: 

;A /dev/rdsk/f0d9dt 

The next time you enter the VP/ix Environment, your new 
configuration file will be in effect. For more information about 
configuring your VP/ix Environment, refer to “VP/ix Maintenance 
Procedures” in this guide. To understand the naming conventions 
used to access each device (such as /dev/rdsk/f 0d9dt), con¬ 
sult “386/ix Maintenance Procedures” in the 386/ix Operating Sys¬ 
tem Guide. 

The secondary display that appears on the right when you use the 
VP/ix Interface Menu tells you which devices you have available, 
and which UNIX files they are mapped to. 


VP/ix Version 1 . 1 

( ESC ) ape menu 
(F)loppy release 

(P) rinter flush 

(Q) uit VP/ix 

(R) eset VP/ix 
( S ) ound OFF 

(C)lose serial 
(E)nter shell 


Device 

Assignment 

A: 

/dev/rdsk/f Oql5dt 

C: 

/usr/vpix/defaults/C: 

Terminal 

Assignment 

AT386 

/dev/console 


If the display says that the device is released, then you will 
have access to it only if it is not being currently accessed by another 
user. If no entry for a device appears, this indicates that there is no 
valid, uncommented entry for the device in your VP/ix 
Configuration File. 





DOS and VP/ix Command Summary 

Command 

Action 

Example 

Equivalent 

UNIX Command 

cd 

Change from one di¬ 
rectory to another 

cd \tony\memos 

cd /tony/memos 

chkdsk 

Scan a diskette for errors 

chkdsk a: 


copy 

Copy one or more files 

copy a : elm z : oak 

cp elm oak 

del 

Delete one or more files 

del a:tree 


dir 

Display the contents of 
the indicated directory 

dir \joe 

Is -1 /joe 

diskcopy 

Copy one disk to another 

diskcopy a : b : 


erase 

Delete one or more files 

erase a:tree 

rm -r tree 

find 

Search for a specified 
string of text in a file 
or files 

find "Li" file . 1 

grep "Li " f ile . 1 

format 

Prepare a diskette for 
use by DOS 

format a: 

format /dev/rdsk/f0d9dt 

mkdir 

Create a directory 

mkdir letters 

mkdir letters 

more 

Send output to the 
display one screen full 
at a time 

more <file.1 

pg file . 1 

path 

Set the DOS search path 

path \deb\games 

PATH=/deb/games 

rename 

Give a file a new name 

rename oak elm 

mv oak elm 
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DOS and VP/ix Command Summary (continued) 


<1 

o 


Command 

Action 

Example 

Equivalent 

UNIX Command 

rmdir 

Delete a directory 

rmdir files.dir 

rmdir files.dir 

sort 

Sort and then write 
the sorted data 

sort file. 1 

sort file.1 -o file. 1 

type 

Display a file on the 
screen 

type elm 

cat elm 

copy 

/d 

/u 

Used with options to 
convert DOS-style file 
formats to UNIX-style 
file formats and vice 
versa 

copy /d u. txt d . txt 
copy /u d . txt u. txt 

lef u. txt d . txt 
lef d . txt u. txt 

dospath 

Convert to DOS-style 
file separators and 
switch characters 

dospath 


lef 

Convert DOS files to 

UNIX files or UNIX 
files to DOS files 

lef elm elm.unx 

lef elm elm.unx 

unixpath 

Convert to UNIX-style 
file separators and 
switch characters 

unixpath 


xdir 

Display contents of the 
indicated directory, 
including file access 
UNIX permissions 
and real file names 

xdir z:\usr\amy 

Is -1 /usr/amy 
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Appendix B: DOS UNDER THE VP/ix ENVIRONMENT 


This appendix is intended for experienced DOS users. It summar¬ 
izes the major differences between DOS under VP/ix and native 
DOS. The major headings in this appendix generally parallel the 
sections of the primer; if you need more information, refer to the 
appropriate section. 

Understanding Disks and Drives 

VP/ix Drive Assignments. The default drive name assignments in 
the VP/ix Environment are shown below: 


Drive Name 

Device 


the first diskette drive 

B 

the second diskette drive 

C 

the bootable DOS image 
on the fixed disk drive 

Z 

the UNIX file system 
on the fixed disk drive 


The default drive is Z. The C drive should only be used to alter 
autoexec.bat or to add DOS drivers. It is only writable by 
you if your system administrator gave you a private copy of the C 
drive when you were installed as a VP/ix user. Drive assignments 
and the default drive assignment can be altered. Consult your sys¬ 
tem administrator for more information. 

On a VP/ix system the diskette drive is referred to as drive A. Not 
all VP/ix users have access to drive A. To gain access, you must 
revise the VP/ix configuration file. To learn how to do this, consult 
your system administrator or read the section entitled “CONFIGUR¬ 
ING THE VP/ix ENVIRONMENT.” 

Only one user can use the diskette drive at a time. When you exit 
the VP/ix Environment, the diskette drive is automatically released. 
If you are finished with the diskette drive, but want to remain in the 
VP/ix Environment, re lease the di skette drive by invoking the VP/ix 
Interface Menu (using ISYS-REQI ) and selecting the release diskette 
drive option (f). 
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Using the Z Drive. In the VP/ix Environment, the multi-user file 
system is located on the Z drive. This is the UNIX file system and 
it is located on the fixed disk. This is the same file system you 
access when you log into the 386/ix Operating System. 

Using DOS Commands 

DOS and UNIX Command Differences. The UNIX operating sys¬ 
tem is case sensitive, which means that it distinguishes between 
uppercase and lowercase letters; the DOS system is not. When 
using a UNIX command, you may not use either uppercase or 
lowercase characters; you must type the command in the correct 
case. 

On DOS systems, you can sometimes abbreviate command names to 
two or three letters; this is not true of UNIX commands. 

DOS command options begin with a slash (/); UNIX command 
options begin with a dash (-). 

UNIX Commands. Certain UNIX programs that are not part of the 
VP/ix Environment, such as cpio and tar, use different strategies 
for storing data on diskettes. Disks created using these programs 
cannot be used by the DOS system. 

Using and Naming Files 

Acceptable File Names for DOS and UNIX. When accessing the 
UNIX file system through the DOS Z drive, UNIX file names that 
do not follow DOS naming conventions will be changed to unique 
DOS names, usually containing one or more tildes (-). The xdir 
command can be used to determine the real UNIX name of the file. 

ttr To make a UNIX file name identical in both UNIX and DOS, 
give it a name that is acceptable to DOS and contains only 
lowercase letters. 

File Systems and Directories 

Path Names. DOS path names are separated by backslashes (\); 
UNIX path names are separated by slashes (/). 
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DOS path names frequently include a drive name (A: or B:, for 
example); UNIX path names do not use drive names. 

The file naming conventions above are also applicable to directory 
names. If VP/ix is started from a directory with a name that does 
not map exactly to a DOS directory name, the user will be logged 
into the default drive’s root directory. 

Basic DOS Commands 

Some common DOS commands must be used differently in the 
VP/ix Environment. These differences are listed below. 

format 

Although the format command is sometimes used to 
format fixed disks in standard DOS systems, it should 
not be used for that purpose in the VP/ix Environment. 

diskcopy 

The di skcopy command can be used on diskettes 
only. It is not intended for use on fixed disks. 

chkdsk 

You cannot use the chkdsk command on the Z drive 
since Z is not a DOS file system. The Z drive contains 
the UNIX file system. 

copy 

You can convert text between DOS and UNIX formats 
using the copy command with the /d or /u options. 
For example: 

copy unix . doc dos . doc /d 

is used to copy the unix. doc file to dos . doc, con¬ 
verting the UNIX file format to DOS file format. 

To copy a DOS file to UNIX format, use the /u option 
of the copy command. For example: 

copy dos . doc unix . doc /u 

is used to copy the dos . doc file to unix. doc, con¬ 
verting the DOS file format to UNIX file format. 
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Using DOS and UNIX Commands Together 

Running DOS Commands From the UNIX Prompt. All DOS com¬ 
mands, even when run from a UNIX prompt, follow standard DOS 
conventions. That is, you must use the slash character (/) to indi¬ 
cate options and the backslash (\) as the separator in path names. 

Users running DOS commands directly from the UNIX shell should 
note that certain special characters (such as the DOS wildcard char¬ 
acters * and ?, the DOS file separator \, and the DOS switch char¬ 
acter /) are interpreted by the UNIX shell. In these cases the sys¬ 
tem may behave in an unexpected manner. To avoid this problem, 
enclose arguments to DOS commands in single quotes (') when run¬ 
ning them from the UNIX shell. 

Running DOS Applications From the UNIX Prompt. To run a DOS 

application at the UNIX prompt, the application must be installed 
on the fixed disk; you cannot run DOS applications that are stored 
on diskettes from the UNIX prompt. 

Running UNIX Commands From the DOS Prompt. A UNIX com¬ 
mand run in the VP/ix Environment is not able to access files stored 
on DOS drives A, B, and C. Only files located on the Z drive, i.e., 
in the standard UNIX file system, can be used as arguments. Also, 
the UNIX option and path separator characters (- and /, respec¬ 
tively) must be used. 


Configuring the VP/ix Environment 

The DOS File autoexec.bat. When you enter the VP/ix 
Environment, the DOS system searches the disk for the 
autoexec . bat file. It must be located in the root directory of 
the fixed disk or in the bootable image of the DOS file used to boot 
the VP/ix Environment. The autoexec.bat file is not optional 
under the VP/ix Environment. If you have your own copy of the 
bootable DOS image, it must contain an autoexec . bat file with 
certain required entries. For more information, see “VP/ix Mainte¬ 
nance Procedures” in this guide or consult your system 
administrator. 
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The VP/ix Configuration File (vpix.cnf). To use a diskette 
drive while in the VP/ix Environment, your system administrator 
must have given you access to the diskette drive. If you cannot 
access the diskette drive, check the VP/ix configuration file found in 
your home directory ($HOME/vpix/vpix.cnf) on the Z drive 
for an A drive entry. If there is an entry for A, be sure there is not 
a semicolon (;) in front of it. If there is no entry for A, it must be 
added; consult your system administrator. 
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Appendix C: USING ASCII TERMINALS 

VP/ix users who are using an ASCII terminal should be aware of 
the following: 

• There are three basic differences between an ASCII terminal and 
a system console: 

1. The keyboards. 

2. The characters that the terminal is capable of displaying 
on the screen. 

3. The need for special key sequences for refreshing a garbled 
screen (which cannot happen on a console) and for “rock¬ 
ing” between the 1 st through the 24 th and 2 nd through 25 th 
lines of the screen (since the console has 25 lines and most 
ASCII terminals have only 24). 

• Only a limited set of the hundreds of different models of ASCII 
terminals is explicitly supported by VP/ix. These include the 
Wyse® 60, the AT&T 605, the DEC™ VT52™, and the DEC 
VT100™. Support for these terminals is custom-tailored, which 
means that all of the keys on these terminals’ keyboards are used 
in simulating the console keyboard, and all of the output charac¬ 
ters that it is possible to display on each terminal are used in 
simulating console output. 

• For all other terminal models, one generic set of keyboard map¬ 
pings is used. This is shown in the next table. Special sequences 
for rocking and refreshing the screen are also included. Further¬ 
more, all non-ASCII screen output characters are represented by 
a dot (. ), regardless of whether the terminal has the capacity to 
display them. In addition, screen attributes such as blinking or 
reverse video may not be properly displayed. Note that it is pos¬ 
sible to tailor support for your terminal model even if it is not 
explicitly supported by VP/ix, as described previously. Consult 
your system administrator, or read Appendix A of “VP/ix 
Maintenance Procedures” in this guide for details. 

• Not all DOS applications can be run on an ASCII terminal. 
Applications that can run on a monochrome display will operate 
on an ASCII terminal; those that require EGA or CGA support 
will not. 
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• A mouse controller cannot be used from an ASCII terminal. 
Applications should be configured accordingly. 

• On an ASCII terminal, when running DOS commands at the 
UNIX prompt or UNIX commands at the DOS prompt, the sys¬ 
tem will display the message: 

[Press Enter to Continue] 

after processing the command. Use I RETURN] to return to the 
UNIX or DOS prompt. 


Generic ASCII Terminal Key Mapping 

PC Key 

Equivalent ASCII 
Terminal Key Sequence 

FI 

ESC 1 

F2 

ESC 2 

F3 

ESC 3 

F4 

ESC 4 

F5 

ESC 5 

F6 

ESC 6 

F7 

ESC 7 

F8 

ESC 8 

F9 

ESC 9 

FI 0 

ESC 0 

SYS-REQ 

ESC s 

t 

ESC " 

i 

ESC v 

—► 

ESC > 

<— 

ESC < 

depress ALT 

ESC a 

release ALT 

ESC A 

depress CTRL 

ESC c 

release CTRL 

ESC C 

depress left SHIFT 

ESC 1 

release left SHIFT 

ESC L 

depress right SHIFT 

ESC r 

release right SHIFT 

ESC R 

CAPS LOCK 

ESC K 

NUM LOCK 

ESC N 

SCROLL LOCK 

ESC S 

HOME 

ESC h 
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Generic ASCII Terminal Key Mapping 


Equivalent ASCII 

PC Key 

Terminal Key Sequence 

PG UP 

ESC u 

PG DN 

ESC n 

END 

ESC e 

DEL 

ESC d 

INS 

ESC i 

PRTSC 

ESC p 

BREAK 

ESC b 

<- TAB 

ESC TAB 

- on numeric keypad 

ESC - 

+ on numeric keypad 

ESC + 

blank (under 5) on numeric 

ESC SPACEBAR 

keypad 


* under PRTSC key 

ESC * 

rocker key 

ESC / 

refresh screen 

ESC , 
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access permissions 

See file access permissions. 

append 

To add text to the end of an existing file, 
application 

A program that is written to perform a specific task, 
such as word processing, database manipulation, or 
accounting. 

argument 

A string of text that accompanies a command and gives 
the computer additional information to modify the result 
of the command. 

batch file 

A file containing DOS commands, named with the . BAT 
extension, used to run the commands in the order listed. 

boot 

To load an operating system or a standalone program 
into memory and execute it. 

byte 

A unit for storing data in a computer, 
case insensitive 

Does not distinguish between uppercase letters and 
lowercase letters. 

case sensitive 

Distinguishes between uppercase letters and lowercase 
letters. 

command 

An instruction the user gives to the computer. The com¬ 
mand is interpreted by the computer, which then runs 
the program that performs the task requested by the 
command. See also argument and option. 

command line 

The complete instruction the user gives to the computer, 
including the command name, options, arguments, and 
pipes. 
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console 

The main keyboard and monitor on a computer, 
current directory 

The directory in which you are located. Its path name is 
displayed on the screen when you use the cd command. 

default 

The alternative chosen by the system when no choice is 
specified by the user. 

destination drive 

See target drive. 

device specifier 

The name of a disk drive. 

directory 

A special type of file that contains other files and/or 
directories. A typical directory contains related docu¬ 
ments, such as memoranda or monthly sales reports. 

disk drive 

See drive. 

diskette 

A device used for storing data (also known as a “floppy 
disk”). Data is stored or read on a diskette by inserting 
the diskette into a disk drive, then issuing the appropri¬ 
ate command. 

drive 

A device on which a disk can be placed to be used for 
storing data. Also called a disk drive. 

extension 

See file name extension. 
external command 

Any file with a file name extension of com, exe, or 
bat. 

file 

A collection of information stored on the computer. For 
example, a file could be a list of phone numbers, a 
memorandum, or a report. 
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file access permissions 

In the VP/ix Environment, file access permissions deter¬ 
mine who can read or write a file or directory stored on 
the Z drive. They are indicated by the letters r (read) 
and w (write). The permissions can be viewed by using 
the xdir command to list the contents of a directory. 
Permissions can be changed using the UNIX chmod 
command. 

file name extension 

That portion of a full DOS file name that follows the 
period. It can be one to three characters in length. 

file system 

A collection of individual files and directories that are 
stored on a portion of a disk. 

filter 

A program that accepts its input from one source, such 
as the standard input, performs the appointed task on 
the data, and then writes the results to the standard out¬ 
put without changing the input file in any way. 

fixed disk 

A medium for storing data. The fixed disk is per¬ 
manently attached to your computer system. Also called 
a hard disk. 

flag 

An option to a command. See option. 
full path name 

The path name of a file that completely describes the 
location of the file in the system. It is the sequence of 
directories from the root directory to the file or direc¬ 
tory you wish to reference. In the DOS system, it con¬ 
sists of a backslash (\), followed by one or more direc¬ 
tory names, and a file name, each separated by a 
backslash. UNIX path names begin with a slash (/), 
and the components are separated by slashes. 

graphics application 

An application that puts the console into “graphics 
mode,” where dots (pixels) on the screen can be turned 
on or off individually. This is in contrast to “text 
mode,” where only entire characters on the screen can 
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be manipulated. Graphics applications can only run on 
consoles that are equipped with special monitors, for 
example, EGAs or CGAs. 

group 

A group is a collection of users. Permission for a group 
refers to the second of three permissions for a file or 
directory. These apply to members of the owner’s group 
only. 

hard disk 

See fixed disk. 

hardware 

The physical components of a computer. Examples 
include the keyboard, the screen (sometimes called the 
display or the monitor), and the printer. 

hierarchical file system 

A directory structure that is arranged in a ranked series, 
with a single master directory at the top level and addi¬ 
tional levels of directories or files defined beneath it. 

home directory 

The directory in which you are placed when you initially 
log into a computer system. It contains the “master 
list” or index of the information you are personally stor¬ 
ing on the computer. Most multi-user systems automati¬ 
cally place you in your home directory when you log in. 

install 

To make software available on your computer. For 
example, an operating system must be installed on your 
computer before you can use it. 

internal command 

The simplest, most commonly used commands on a DOS 
system. These commands are part of a large file named 
command. com. 

log in 

To type your login name and password onto your com¬ 
puter or terminal, indicating that you are ready to gain 
access to your information. 

login directory 

See home directory. 
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login account 

The information stored in a computer that provides 
authorization for a person to use that computer’s 
resources. The computer’s system administrator usually 
sets up login accounts. 


log out 


To terminate your access to the system, 
terns, this is accomplished by holding down the 
key while simultaneously typing d. 


On UNIX sys- 
CTRLl 


multi-user 

Capable of supporting more than one user at a time. On 
a multi-user computer system, each user has his or her 
own terminal plugged into the computer and all can 
share its data and resources at the same time. 


operating system 

The operating system is part of the system software. It 
is a program that tells the computer how to manage its 
operations, process and execute the user’s requests, and 
run application software. 

option 

An optional argument that is available to modify the 
results of a specific command. Options are preceded by 
a slash (/) on the DOS operating system. On UNIX 
systems, options are preceded by a dash (-). 

other 

The third of three permissions for a file or directory, 
which applies to everyone on the system who is neither 
the owner nor in the owner’s group. 

overwrite 

To perform an operation on a file that deletes its con¬ 
tents and replaces it with the output of the operation. 
For example, if you sort a file and use the name of an 
already existing file as its destination, the contents of the 
original file is replaced with the contents of the new file. 


owner 

The user who creates a file and has control over the file’s 
permissions. 
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path 

The list of directories through which the UNIX or DOS 
command processors look to find programs to be exe¬ 
cuted. This list is made available to the appropriate 
command processor through a specific environment vari¬ 
able. Also used as a shortened term for path name. 

path name 

The sequence of directory names and (optionally) a file 
name, separated by backslashes (\) on DOS or by 
slashes (/) on UNIX systems, that describes the location 
of a file or directory. 

pattern matching character 
See wildcard. 

permissions 

See file access permissions. 

pipeline 

To take the output of one program and direct it to be 
the input to another program. 

pipes 

Connections between two or more commands, indicated 
by a vertical bar symbol ( I ). 

program 

A set of instructions for a specific set of tasks, written in 
a machine or programming language, that tells the com¬ 
puter how to perform the tasks. 

prompt 

A symbol that displays on the screen to indicate that the 
system is ready to receive your commands. You may 
execute a command or run an application when the 
prompt is displayed. 

read permission 

Allows a user to view the contents of the file or copy it 
to another area. Read permission by itself does not 
allow a user to change a file. 

reboot 

To reload an operating system or a standalone program 
into memory and execute it. 
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redirection 

To change the destination of the output or the input of a 
command. 

relative path name 

The path name of a file or directory, omitting the root 
directory and directory names up to the current 
directory. 

root directory 

The top-level directory, designated by a backslash (\) 
on DOS systems and by a slash (/) on UNIX systems. 
All other directories in the system are under the root 
directory. 

serial communications port 

Part of a computer that receives data from or transmits 
data to an external remote device. On DOS systems the 
serial ports are usually given the names COM1 : and 
COM2:. 

single-user 

Capable of supporting only one user at a time. On a 
single-user computer operating system, no one else can 
simultaneously share the computer’s data or resources. 
Most small personal computers are single-user systems. 

software 

The instructions that make a computer perform its func¬ 
tions. Software is divided into two main groups: appli¬ 
cations and the operating system. Application software 
performs specific tasks, such as word processing, 
spreadsheets, educational programs, and games. The 
operating system software tells the computer how to run 
application software. 

source drive 

The drive from which you are taking information. For 
example, when copying a diskette, the diskette drive that 
contains the diskette to be copied is the source drive. 
See also target drive. 

spooler 

A program that gathers up data and enqueues it for pro¬ 
cessing by another program or a piece of hardware (such 
as a printer). 
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standard input 

Information coming from the keyboard, unless otherwise 
specified by the user. The user can specify that informa¬ 
tion come from a file, a device, or a pipe. 

standard output 

The destination of a program’s data, considered to be 
the terminal screen, unless otherwise specified by the 
user. The user can specify that information be written 
to a file, a device, or a pipe. 

string 

A series of characters surrounded by spaces. 

switch 

An option provided to a command. See option. 
system administrator 

The person responsible for maintaining a computer 
system. 

target drive 

The drive to which you will transfer information. For 
example, when copying a diskette, the diskette drive that 
contains the blank diskette is the target drive. 

variable 

A string that has special meaning to the operating sys¬ 
tem. It is usually assigned a value. 

VP/ix Interface Menu 

The VP/ix resource menu invoked by using ISYS-REQ] . 
This menu is used to control system resources available 
to each VP/ix user. 

wildcard 

A wildcard is a character that is used to match any 
character or string of characters in a file or directory 
name. It is a type of shortcut. 

write permission 

Allows a user to make changes to a file. Write permis¬ 
sion on a directory allows a user to create and delete 
files in that directory. 
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VP/ix Installation Instructions 


1. OVERVIEW 

The VP/ix™ Environment is installed on your fixed disk using the 
sysadm utility. It is comprised of two subsets: 

• The VP/ix Core and MS-DOS® subset contains the base VP/ix 
Environment. It requires about 1.3 MB of disk space and 
requires that the 386/ix™ Core subset already be installed. It is 
distributed on two diskettes. 

• The VP/ix Configuration subset is optional and may be installed 
by those users who plan to customize the VP/ix Environment 
(i.e., to support third-party hardware devices). It takes about 
0.5 MB of disk space and requires that the 386/ix Kernel 
Configuration subset already be installed. It is distributed on 
one diskette. 

This document assumes that you have read and understood the fol¬ 
lowing documents in the 386/ix Operating System Guide: 

• “386/ix Installation Instructions” 

• “386/ix Maintenance Procedures” 

• “UNIX Primer” 

These documents were delivered with your 386/ix Operating 
System. 


386/ix is a trademark of INTERACTIVE Systems Corporation. 

VP/ix is a trademark of INTERACTIVE Systems Corporation and Phoenix 
Technologies Ltd. 

UNIX is a registered trademark of AT&T. 

DEC, VT52, and VT100 are trademarks of Digital Equipment Corporation. 

AT, IBM, and IBM PC are registered trademarks of International Business 
Machines Corporation. 

KT-70/PC is a registered trademark of Kimtron Corporation. 

MS-DOS is a registered trademark of Microsoft Corporation. 

Wyse is a registered trademark of Wyse Technology. 
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2. INSTALLING THE VP/ix ENVIRONMENT 

1. To begin the installation, use the System Administration com¬ 
mand, sysadm, or log in as sysadm to access the Main 
menu. Your screen will look similar to this: 


f - 


SYSTEM ADMINISTRATION 

1 

diskmgmt 

disk management menu 

2 

filemgmt 

file management menu 

3 

machinemgmt 

machine management menu 

4 

packagemgmt 

package management menu 

5 

softwaremgmt 

software management menu 

6 

syssetup 

system setup menu 

7 

ttymgmt 

tty management menu 

8 

usermgmt 

user management menu 

Enter a number, a 

name, the initial part of a name, or 

? or 

<number>? for 

HELP, q to QUIT: 


2. Type 5 to access the Software Management menu. Your 
screen will then look similar to this: 



SOFTWARE MANAGEMENT 

1 installpkg install new software package onto built-in disk 

2 listpkg list packages already installed 

3 removepkg remove previously installed package from built-in disk 

4 runpkg run software package without installing it 

Enter a number, a name, the initial part of a name, or 
? or <number>? for HELP, * to GO BACK, q to QUIT: 



3. Select option 1, installpkg. The system prompts you to 
insert the VP/ix diskette into the diskette drive. The screen 
will look similar to this: 


Insert the removable medium for the package you want to 
install into the diskette drive. 

Press <RETURN> when ready. Type q to quit. 





VP/ix Installation Instructions — Release 1.1.0 


3 


4. Insert the Core and MS-DOS diskette for the VP/ix Environ¬ 
ment labeled “ 1 of 2” into the diskette drive. The system asks 
you to confirm that this is the package you want to install. 
Use | RETURN] to start the installation process. (The file 
names listed below may appear in a different order during 
your installation.) 

Install the VP/lx Environment Core- Version 1.0.1 Package? (y) 
Installing the VP/ix Environment Core- Version 1.0.1 
Copyright (c) 1988 Interactive Systems Corp. and Phoenix 

Technologies Ltd. 

All Rights Reserved 

The following files are being installed: 

/usr/options/vp.name 
/usr/vpix/dosbin/append.exe 
/usr/vpix/dosbin/assign.com 
/usr/vpix/dosbin/attrib.exe 


/usr/vpix/vpix 
1900 blocks 

Floppy diskette number 1 is complete 
Remove floppy and insert floppy number 2 

Type <return> when ready: 

5. Insert the Core and MS-DOS diskette labeled “2 of 2” and use 
I RETURN! to continue the installation. 

/usr/vpix/defaults/C: 

/usr/vpix/defaults/cmos 


/usr/vpix/dosbin/ansi.sys 
540 blocks 

Installing the VP/ix Environment. One moment, please... 
Linking in UNIX-under-DOS commands... 

The VP/ix Environment has been installed. 

Please use the sysadm packagemgmt menu option for 
individual VP/ix user installations. 

Floppy diskette number 2 is complete 

Installation of the VP/ix Environment Core- Version 1.0.1 
is complete 

You may now remove the medium from the diskette drive. 

6. The VP/ix Environment Core subset is now installed on your 
fixed disk. To install the Configuration subset, repeat this pro¬ 
cedure using the Configuration diskette for the VP/ix 
Environment. 





4 


VP/ix Installation Instructions — Release 1.1.0 


3. CONFIGURING LOGIN ACCOUNTS FOR THE 
VP/ix ENVIRONMENT 

Before a user can access the VP/ix facilities, VP/ix privileges must 
be added to each individual login account. This section explains 
how to configure a login account for use with the VP/ix Environ¬ 
ment; it assumes that you have already established user login 
accounts as described in section 3.8.3 of the “386/ix Installation 
Instructions.” Refer to “386/ix Maintenance Procedures” if you 
need to learn how to add a new user login account. 

1. To add VP/ix privileges to user accounts, use the System 
Administration command, sysadm, or log in as sysadm to 
access the Main menu. Your screen will look similar to this: 


SYSTEM ADMINISTRATION 


1 diskmgmt 

2 filemgmt 

3 machinemgmt 

4 packagemgmt 

5 softwaremgmt 

6 syssetup 

7 ttymgmt 

8 usermgmt 


disk management menu 
file management menu 
machine management menu 
package management menu 
software management menu 
system setup menu 
tty management menu 
user management menu 


Enter a number, a name, the initial part of a name, or 
? or <number>? for HELP, q to QUIT; 


2. Select option 4 to access the Package Management menu. 
Your screen will then look similar to this: 


PACKAGE MANAGEMENT 

1 uucpmgmt basic networking utilities menu 

2 vpixmgmt install users for the VP/ix Environment 

Enter a number, a name, the initial part of a name, or 
? or <number>? for HELP, * to GO BACK, q to QUIT; 


There may be additional options on your screen, depending on 
the number of subsets purchased. 
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3. Select the option named vpixmgmt to access the VP/ix 
Management menu. Your screen will look similar to this: 


VP/ix MANAGEMENT 


1 addvpixuser 

2 delvpixuser 

3 ddainstall 

4 ddaremove 

5 vconfig 


enable users to use the VP/ix Environment 
disable users from using the VP/ix Environment 
install a DDA device into the VP/ix Environment 
remove a DDA device from the VP/ix Environment 
change device parameters and reconfigure VP/ix 


Enter a number, a name, the initial part of a name, or 
? or <number>? for HELP, A to GO BACK, q to QUIT: 


4. Select option 1. The system responds: 

Do you wish to set up a new VP/ix user? [y, n, ?, q] 

5. Type y. The system then asks for the user’s login ID: 

Enter the User's login ID : 

6. Enter the user’s login ID, jane, for example. Next, the sys¬ 
tem asks whether the user should be given a local copy of the 
C drive. The C drive is usually the fixed disk drive. By 
default, VP/ix is booted from the C drive. 

Should user jane have a private copy 

of the C: drive? (Default is "n" ) [y, n, ?] 

7. Type 1 RETURN] to accept the default (n). In some cases you 
may wish to give experienced users their own copies of the C 
drive. Refer to “VP/ix Maintenance Procedures” for a 
detailed discussion of this issue. The system displays a mes¬ 
sage similar to this: 

User jane can now use the VP/ix Environment 

8. It then offers you the opportunity to install other VP/ix users: 

Do you wish to set up a new VP/ix user? [y, n, ?, q] 

Type y to repeat the procedure for another user, or type n to 
quit. 

ttr Remember, you must use this procedure each time you add a 
new user to your system if the new user is to have access to the 
VP/ix Environment. 

You can reverse the actions described here by choosing option 2, 

delvpixuser, from the VP/ix Management menu in step 3. 

Note that this procedure will remove all files and directories under 
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the user’s $HOME/vpix directory. You should warn the user to 
save any files he or she may have edited or added under this direc¬ 
tory before you delete that person as a VP/ix user. 
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The VP/ix Environment Core and MS-DOS subset is distributed on 
two diskettes. The contents of the diskettes are copied to the 
/usr/vpix directory on your fixed disk. This section briefly 
describes the files distributed with the VP/ix Environment. 

• /usr/admin/menu/packagemgmt/vpixmgmt 

The directory used by the sysadm utility to locate new VP/ix 
Environment management shell scripts. 

/usr/admin/menu/packagemgmt/vpixmgmt/DESC 
A description of the scripts in this directory. 

/usr/admin/menu/packagemgmt/vpixmgmt 

/addvpixuser 

The script used to install new VP/ix Environment users onto 
the system. 

/usr/admin/menu/packagemgmt/vpixmgmt 

/delvpixuser 

The script used to remove access of currently installed 
VP/ix users to the VP/ix Environment. 

• /usr/vpix 

The directory where all VP/ix files are stored. 
/usr/vpix/README 

The list of software changes and known problems associated 
with this VP/ix release. 

/usr/vpix/vpix 

The actual vpix command that is linked to /usr/bin 
during installation. 

• /usr/vpix/defaults 

The directory where default user configuration files are stored. 
. These files can be copied to each user’s private vpix directory 
for customization. 

/usr/vpix/defaults/C: 

The default boot image file from which DOS boots. 
Contains DOS boot programs such as io.sys and 
msdos . sys. 
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/usr/vpix/defaults/cmos 

The default CMOS image file used by the VP/ix Environ¬ 
ment to retain CMOS information normally stored in bat¬ 
tery backup CMOS RAM. 

/usr/vpix/defaults/rom 

Retains for the VP/ix Environment the default BIOS nor¬ 
mally stored in the computer’s ROM. 

/usr/vpix/defaults/romega 

Retains for the VP/ix Environment the default EGA BIOS 
normally stored in the Enhanced Graphics Adapter’s ROM. 

/usr/vpix/defaults/romvga 

Retains for the VP/ix Environment the default VGA BIOS 
normally stored in the Video Graphics Adapter’s ROM. 

/usr/vpix/defaults/vpix.cnf 

The default user configuration file that serves as a template 
for each user. 

/usr/vpix/etc 

The directory containing miscellaneous files and directories for 

customized VP/ix environments. 

• /usr/vpix/etc/vpixdevs 

Contains descriptions of nonstandard VP/ix devices, such as 
those supplied by third-party vendors. 

/usr/vpix/term 

A directory containing VP/ix terminal specification files for 

serial terminal support. 

/usr/vpix/term/AT386 

The terminal specification file for an AT® console being 
used as a serial terminal, e.g., during a remote login session. 

/usr/vpix/term/605 

The terminal specification file for an AT&T 605 PC- 
compatible terminal. 

/usr/vpix/term/generic 

The terminal specification file used if none matching the 
user’s terminal is found in this directory. 
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/usr/vpix/term/ibm3151 

The terminal specification file for an IBM® 3151 PC- 
compatible terminal. 

/usr/vpix/term/kt70 

The terminal specification file for a KT-70/PC® terminal 
from Kimtron Corporation. 

/usr/vpix/term/sys.default 

The VP/ix terminal-independent specification file, used for 
all terminals. 

/usr/vpix/term/vt100 

The terminal specification file for a DEC™ VT100™ 
terminal. 

/usr/vpix/term/vt52 

The terminal specification file for a DEC VT52™ terminal. 

/usr/vpix/term/wyse60 

A link to /usr/vpix/term/wyse. 

/usr/vpix/term/wyse 

The terminal specification file for a Wyse®-60 terminal run¬ 
ning in PC mode. 

• /usr/vpix/unixbin 

The directory containing files that allow cross-execution of 
UNIX® programs from DOS. Note that when VP/ix is installed, 
several new files are created in this directory (see section 3.2 of 
“VP/ix Maintenance Procedures” for details). 

/usr/vpix/unixbin/rununix.exe 

A DOS program that allows execution of UNIX programs 
from within the VP/ix Environment. 

• /usr/vpix/dosbin 

A directory containing standard MS-DOS 3.3 distribution pro¬ 
grams and some VP/ix-specific DOS executable programs. 

/usr/vpix/dosbin/ansi.sys 

The DOS device driver for ANSI terminal emulation. 

/usr/vpix/dosbin/append.exe 

Locates files outside of the current directory with extensions 
other than . COM, . EXE, and . BAT. 
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/usr/vpix/dosbin/assign.com 
Assigns a drive letter to a different drive. 

/usr/vpix/dosbin/attrib.exe 
Sets or displays attributes of a file. 

/usr/vpix/dosbin/backup.com 

Backs up files from a fixed disk to another device. 

/usr/vpix/dosbin/chkdsk.com 

Scans the directory of the default or designated drive and 
checks for consistency. 

/usr/vpix/dosbin/command.com 

The DOS Command Processor that is the equivalent of the 
UNIX shell. 

/usr/vpix/dosbin/comp.com 
Compares the contents of two files. 

/usr/vpix/dosbin/country.sys 
Default country information file. 

/usr/vpix/dosbin/debug.com 
The DOS debugger. 

/usr/vpix/dosbin/dir.bat 

A file that enables the execution of the DOS dir command 
from the UNIX environment. 

/usr/vpix/dosbin/diskcomp.com 
Compares the contents of two diskettes. 

/usr/vpix/dosbin/diskcopy.com 

Copies the contents of one diskette to another. 

/usr/vpix/dosbin/display.sys 

Allows code page switching for foreign font displays. 

/usr/vpix/dosbin/dosmount.exe 

Allows DOS drive letters to be assigned to subdirectories in 
the UNIX file system. 

/usr/vpix/dosbin/dospath.exe 

Sets the DOS switch character to and the directory 
separator character to “\”. 

/usr/vpix/dosbin/driver.sys 
Standard DOS loadable device driver. 
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/usr/vpix/dosbin/edlin.com 
The standard DOS line editor. 

/usr/vpix/dosbin/ega.cpi 

Code page information table for EGA displays. 

/usr/vpix/dosbin/ems.sys 

A DOS-loadable device driver that provides support for 
extended memory. 

/usr/vpix/dosbin/exe2bin.exe 

Converts executable (. exe) files to binary format. 

/usr/vpix/dosbin/fastopen.exe 

DOS command to store in memory the location of direc¬ 
tories and recently opened files. 

/usr/vpix/dosbin/fdisk.com 

Partitions a fixed disk (usable only on drive C in the VP/ix 
Environment). 

/usr/vpix/dosbin/find.exe 

Searches a file for a constant string of text. 

/usr/vpix/dosbin/format.com 

Formats a fixed disk or diskette to receive DOS files. 

/usr/vpix/dosbin/graftabl.com 
Loads a table of graphics characters. 

/usr/vpix/dosbin/graphics.com 
Prepares DOS for printing graphics. 

/usr/vpix/dosbin/gwbasic.exe 
BASIC programming language interpreter. 

/usr/vpix/dosbin/join.exe 
Joins a disk drive to a path name. 

/usr/vpix/dosbin/keyb.com 
Loads foreign keyboard programs. 

/usr/vpix/dosbin/keyboard.sys 

Contains tables that direct the keyb.com command to 
convert scancodes to ASCII characters. 

/usr/vpix/dosbin/label.com 

Allows labeling of fixed disks or diskettes. 
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/usr/vpix/dosbin/lcd.cpi 

Code page information table for IBM PC® Convertible LCD 
displays. 

/usr/vpix/dosbin/1ink.exe 
The standard DOS linker program. 

/usr/vpix/dosbin/mode.com 

Modifies parameters for the screen, printer port, and com¬ 
munications port. 

/usr/vpix/dosbin/more.com 
Displays output one screen at a time. 

/usr/vpix/dosbin/nlsfunc.exe 

Provides support for DOS extended country information. 

/usr/vpix/dosbin/print.com 
Prints a file on the line printer. 

/usr/vpix/dosbin/quit.com 
Exits the VP/ix Environment. 

/usr/vpix/dosbin/ramdrive.sys 

The standard DOS RAM disk driver. In the VP/ix Environ¬ 
ment, this works only in lower or expanded memory. 

/usr/vpix/dosbin/recover.com 
Recovers a bad disk or file. 

/usr/vpix/dosbin/redir.exe 

The program that provides access to the UNIX file system 
from within the VP/ix Environment. 

/usr/vpix/dosbin/replace.exe 
Replaces previous versions of files. 

/usr/vpix/dosbin/restore.com 

Restores files backed up using backup, com. 

/usr/vpix/dosbin/rundos.com 

A DOS program that allows execution of DOS programs 
directly from the UNIX environment. 

/usr/vpix/dosbin/select.com 

Allows loading of language-specific keyboards and font 
tables. 
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/usr/vpix/dosbin/share.exe 

Installs DOS file sharing and file locking. 

/usr/vpix/dosbin/sort.exe 
Sorts data forward and backward. 

/usr/vpix/dosbin/subst.exe 
Substitutes a string for a path name. 

/usr/vpix/dosbin/sys.com 

Transfers DOS system files from one drive to another. 

/usr/vpix/dosbin/tree.com 
Displays directory and file names. 

/usr/vpix/dosbin/unixpath.exe 

Sets the DOS switch character to ” and the directory 
separator character to “/”. 

/usr/vpix/dosbin/xcopy.exe 
Copies files and subdirectories. 

/usr/vpix/dosbin/xdir.exe 

Displays complete user, group, and protection information 
for files and directories. 
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VP/ix Maintenance Procedures 


1. INTRODUCTION 

This document provides you with an overview of the basic pro¬ 
cedures required to keep the VP/ix™ Environment running 
smoothly. It is intended for system administrators who are familiar 
with UNIX® system maintenance and with the DOS environment. 

1.1 Before You Begin 

Before you attempt any of the procedures outlined in this document, 
you must read and understand the following documents: 

• “VP/ix and MS-DOS Primer” 

• “VP/ix Installation Instructions” 

• “386/ix Maintenance Procedures” in the 386/ix Operating 
System Guide 

You must also be familiar with a text editor if your intended system 
configuration requires you to tailor some of the standard 
configuration files. Refer to the “Documentation Roadmap” to 
determine where to obtain additional information about text editors 
available for your system or additional information about the UNIX 


386/ix is a trademark of INTERACTIVE Systems Corporation. 

VP/ix is a trademark of INTERACTIVE Systems Corporation and Phoenix 
Technologies Ltd. 

UNIX is a registered trademark of AT&T. 
dBASE is a trademark of Ashton-Tate. 

Paradox is a registered trademark of Borland International, Inc. 

VT100 is a trademark of Digital Equipment Corporation. 

Fastback is a trademark of Fifth Generation Systems, Inc. 

Intel is a registered trademark of Intel Corporation. 

80386 and MULTIBUS are trademarks of Intel Corporation. 

AT and VGA are registered trademarks of International Business Machines 
Corporation. 

Lotus and 1-2-3 are registered trademarks of Lotus Development Corporation. 
WordStar is a trademark of MicroPro International, Inc. 

Microsoft and MS-DOS are registered trademarks of Microsoft Corporation. 

MS Windows is a trademark of Microsoft Corporation. 

Ptel is a trademark of Phoenix Technologies Ltd. 
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system. You may also need to refer to the Operations/System 
Administration Guide or any additional documentation supplied by 
your vendor to completely install and tailor your system. 

1.2 Overview of This Document 

This document is divided into nine major sections, including three 
appendices: 

1. INTRODUCTION 

This section provides a general overview of this 
document. 

2. CONFIGURING THE USER ENVIRONMENT 

This section describes how to set up the VP/ix Environ¬ 
ment for a new VP/ix user and how to tailor the 
environment to each user’s needs. It also explains how 
to assign UNIX system devices to the virtual DOS 
devices that VP/ix provides. 

3. CROSS-EXECUTION ENVIRONMENT 

This section explains how to run DOS programs from the 
UNIX environment and UNIX programs from the DOS 
environment. It also explains how to make the 
differences between the two kinds of applications trans¬ 
parent to users. 

4. TROUBLESHOOTING 

This section describes some of the problems that may be 
encountered when using the VP/ix Environment and 
discusses what to do about them. 

5. DOS AND DOS FILES IN THE VP/ix ENVIRONMENT 

This section explains how the version of DOS distributed 
with the VP/ix Environment differs from the standard 
MS-DOS® version 3.3. 

6. ACCESSING NONSTANDARD DEVICES IN THE VP/ix 

ENVIRONMENT 

This section describes the facilities supplied with the 
VP/ix Environment that enable you to add support for 
nonstandard PC hardware devices. 

7. Appendix A: USING VP/ix ON SERIAL TERMINALS 

This section is intended for experienced UNIX system 
administrators who want to use a terminal not already 
supported by their VP/ix vendor. It explains how to 
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configure VP/ix so that DOS users can run applications 
on a wide variety of ordinary ASCII terminals. 

8. Appendix B: VP/ix ERROR MESSAGES 

This section lists the error messages that VP/ix can gen¬ 
erate and provides the possible causes of and resolutions 
for each error. 

9. Appendix C: INCOMPATIBILITIES BETWEEN DOS AND 

VP/ix 

This section describes some of the differences between 
the VP/ix Environment and MS-DOS running as the sole 
operating system on a PC. 
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2. CONFIGURING THE USER ENVIRONMENT 

The VP/ix system administrator is responsible for tailoring the 
VP/ix Environment. This section explains how to configure the 
VP/ix Environment for an individual user. In this section you will 
learn: 

• Why the user environment must be configured. 

• How to tailor the VP/ix configuration file. 

• How to allocate resources to an individual user. 

2.1 Why Configure the VP/ix Environment? 

The VP/ix Environment is designed to allow multiple users to run 
multiple, simultaneous DOS sessions. System resources, such as a 
mouse device, a diskette drive, or a file must be shared by all users 
who require access to that resource. It is important, therefore, to 
ensure that no two users are competing for the same resource. For 
example, on a system with a single serial port and a modem, one 
user might be running a DOS communications package such as 
Ptel™, which uses the serial port and modem. If another user logs 
into the system and also attempts to run Ptel, there will be a prob¬ 
lem. A resource such as a serial port cannot be shared simultane¬ 
ously by two users, so the second user must be denied access to the 
resource. 

A multi-user operating system, such as UNIX, provides basic ser¬ 
vices that regulate the way in which available system resources are 
to be shared. In contrast, the DOS operating system is a single-user 
system. DOS expects only one user on the system at any given time 
and, therefore, makes no provision to limit access to resources. 
Since the DOS system has no mechanism for protecting users from 
competing for a single resource, the VP/ix Environment provides 
this service. 

The VP/ix Environment facilitates resource sharing through the use 
of a “lock” mechanism set up in the user configuration file. The 
user who first enters the VP/ix Environment is given exclusive 
access to all resources enabled in that user’s configuration file. A 
user who enters the VP/ix Environment after these resources are 
locked is denied access to those resources, even though that user’s 
configuration file may support it. The user who is initially allocated 
the diskette drive may make the drive available to other users 
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through the VP/ix Interface Menu. When a user exits the VP/ix 
Environment, all resources allocated to that user are released. 

Because of the resource sharing that is required under VP/ix, a sys¬ 
tem administrator should configure each user’s VP/ix Environment 
to automatically allocate only those resources that are required. For 
example, if a a user typically logs in at the system console, which 
supports a mouse device, that user’s environment should be 
configured to have access to the diskette drive and the mouse device. 
A user who typically accesses the VP/ix system from a serial termi¬ 
nal should not be configured to have access to the diskette drive or 
the mouse device. 

2.2 The VP/ix Configuration File 

The VP/ix configuration file is called vpix. cnf. It is automati¬ 
cally created for each user when the user’s login account is 
configured for VP/ix (refer to section 3 of the “VP/ix Installation 
Instructions”). This default file is copied from the directory 
/usr/vpix/defaults into the user’s $HOME/vpix direc¬ 
tory. Therefore, the default configuration file for each user is the 
same. To make a global change to the VP/ix configuration file, 
modify the file /usr/vpix/def aults/vpix . cnf . This will 
ensure that all VP/ix accounts that are subsequently established will 
receive the new default configuration. You may also tailor each 
user’s individual vpix. cnf file to optimize the use of system 
resources and minimize resource conflicts. 

The purpose of the vpix. cnf file is to associate the standard 
DOS device names (for example, A, C, and COM1) with the stan¬ 
dard UNIX device names. Under the VP/ix Environment, the UNIX 
system is responsible for executing requests to access devices. 
Therefore, the VP/ix Environment must translate DOS device names 
to UNIX device names. For example, the DOS device name for the 
first diskette drive is A. The UNIX device name for the first 
diskette drive is /dev/rdsk/f 0d9dt (assuming the drive is a 
double-density, double-sided diskette drive). Refer to section 8 of 
“386/ix Maintenance Procedures” for more information about 
UNIX device names. 

If the VP/ix Environment is not configured correctly, users will not 
be able to access devices using DOS naming conventions. For exam¬ 
ple, a user might attempt to access drive A with this command: 
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VP/ix C:\> dir a: 

If the user’s configuration file does not contain an entry for drive A, 
the system responds with this message: 

General failure error reading drive A 
Abort, retry, or ignore? 

You must correct the configuration file to correct this error. 

If you modify the VP/ix configuration file from the UNIX shell 
prompt, the changes will be reflected the next time you enter the 
VP/ix Environment. If you make changes to the configuration file 
from within the VP/ix Environment, you must exit and reenter 
VP/ix in order to have the changes take effect. 

The VP/ix configuration file contains a series of entries. Each entry 
is either a comment line, a line that associates a DOS device name 
or auxiliary file with a UNIX device name or file name, or a line 
that defines a nonstandard device name. Lines that begin with a 
semicolon (;) are comment lines. They are not read by the system 
when VP/ix is started. A comment line provides either descriptive 
information or an example of a DOS/UNIX device name entry. 
Remove the semicolon and any extra blank spaces at the beginning 
of a comment line to enable that entry. 
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VP/ix Configuration File 


DOS DEVICE 


UNIX DEVICE PATH NAME 


C 

ROM 

EGAROM 

VGAROM 

CMOS 

BOOTIMAGE 


/usr/vpix/defaults/C: 
/usr/vpix/defaults/rom 
/usr/vpix/defaults/romega 
/usr/vpix/defaults/romvga 
/usr/vpix/defaults/cmos 
$HOME/vpix/vpix.img 


; The following entries are provide as examples 
; for customization of the VP/ix Environment 

; To access the floppy as drive A: uncomment one of the following. 


; For 360K: 

;A /dev/rdsk/f0d9dt 

; For 1.2 Meg 

;A /dev/rdsk/fOq15dt 

; To add an additional floppy which is attached to the second 
; floppy drive (accessible as B:) on your system: 

; For 360K: 

;b /dev/rdsk/f1d9dt 

; For 1.2 Meg 

•b /dev/rdsk/fIql5dt 

; To access an actual DOS partition on the fixed disk: 

;D /dev/dsk/OpO 

; To access a serial communications port: 

;C0M1 /dev/ttyOO 

; To access a serial communications port 
; for use with a serial mouse: 

;C0M1M0USE /dev/ttyOO 


; If you have a Mouse: 

;MOUSE /dev/mouse 

; If you have a line printer and you are using the standard UNIX 
; printer spooler: 

; LPT 1 /usr/bin/lp 

DOS device names in the first column must not be followed by 
colons. For example, LPT 1 is valid, while LPT1: is not. DOS 
device names in the first column must be flush with the left margin. 
For example, using an editor’s destructive backspace to delete the 
semicolon (;) preceding LPT1 is valid, while using an editor to 
space over the semicolon is not. 
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The keyword for each DOS device or auxiliary file, the associated 
UNIX device or file name, and the purpose of each device or file are 
outlined in the following table. 


DOS Device 

Meaning Under DOS 

Sample UNIX Equivalent 

C 

The DOS partition on the 
first fixed disk of a standard 

/usr/vpix/defaults/C: 


DOS system. 


ROM 

A file image of the standard 
MS-DOS BIOS, which is 
stored in the computer’s 

ROM. 

/usr/vpix/defaults/rom 

EGAROM 

For EGA (Enhanced Graph¬ 
ics) adapters. Specifies the 
EGA BIOS to be loaded when 
VP/ix is run. 

/usr/vpix/defaults/romega 

VGAROM 

For VGA® (Video Graphics) 
adapters. Specifies the VGA 
BIOS to be loaded when 

VP/ix is run. 

/usr/vpix/defaults/romvga 

CMOS 

A file image of the CMOS 
information normally stored 
in CMOS RAM. 

/usr/vpix/defaults/cmos 

BOOTIMAGE 

A fast-loading image of the 
user’s VP/ix Environment. 

$HOME/vpix/vpix.img 

A 

The diskette drives in a DOS 

/dev/rdsk/f0d9dt 

B 

system. 


D 

The DOS partition on the 
second fixed disk of a stan¬ 
dard DOS system. 

/dev/dsk/OpO 

COM1 

COM2 

DOS serial ports. 

/dev/ttyO 0 

COM1MOUSE 

DOS serial ports, when 

/dev/ttyO 0 

COM2MOUSE 

used with a serial mouse. 


MOUSE 

Specifies the mouse device to 
be used. 

/dev/mouse 

LPT 1 

DOS printer devices. 

/usr/bin/lp 

LPT2 



LPT3 




The next section describes each line as it appears in the default 
configuration file, explains why you might want to modify it, and, 
where appropriate, provides an example of a modified entry. 
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C /usr/vpix/defaults/C: 

This entry establishes an image of the DOS system 
that is used by each VP/ix user. In a native DOS 
environment, the files and programs that are used to 
boot the system and initiate the environment are nor¬ 
mally stored on the C drive (the fixed disk partition). 
Under the VP/ix Environment, an image of the C 
drive is stored in /usr/vpix/def aults/C:. 
The image contains the same information as is con¬ 
tained in the DOS partition of the C drive on a native 
DOS system. The /usr/vpix/def aults/C: 
file can only be modified by the root user. Refer to 
“386/ix Maintenance Procedures” for more informa¬ 
tion about the root user. 

This entry can be modified if a user wishes to custom¬ 
ize the DOS environment by making changes to the 
autoexec.bat or config.sys files, for exam¬ 
ple. These DOS files are used to set system parame¬ 
ters and are located in the image of the C drive, 
/usr/vpix/def aults/C :. In order to modify 
these files (or any other files located on the C drive) 
without affecting the environment of others, the user 
must have a private copy of the C drive. 

The system administrator can specify whether a user 
should have a private copy of the C drive when the 
sysadm program is run during VP/ix user installa¬ 
tion. The decision to provide a user with a private 
copy of the C drive should be based on familiarity 
with the user’s requirements and the storage limita¬ 
tions of your system (the image of the C drive is a 
large UNIX file). If a user is provided with a copy of 
the C drive, it is placed in the user’s vpix directory 
and made writable by the user. The sysadm pro¬ 
gram automatically edits the user’s vpix . cnf file to 
change the line for the C drive to: 

C $HOME/vpix/C: 

For information about the disadvantages of installing 
DOS software on the C drive, see the section entitled 
“Loading and Using DOS Applications” in the “VP/ix 
and MS-DOS Primer.” 
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ROM /usr/vpix/defaults/rom 

This entry defines a file image of the standard 
MS-DOS BIOS (Basic Input-Output System), which is 
normally stored in the computer’s ROM (read-only 
memory). 

This entry should never be changed by the system 
administrator or by a user. 

EGAROM /usr/vpix/defaults/romega 

This entry specifies a file that contains instructions 
regarding high-resolution adapters, which is to be used 
by the system when the user has an EGA (Enhanced 
Graphics) adapter and display. 

This entry should never be changed by the system 
administrator or by a user. 

VGAROM /usr/vpix/defaults/romvga 

This entry specifies a file that contains instructions 
regarding high-resolution adapters, which is to be used 
by the system when the user has a VGA (Video 
Graphics) adapter and display. 

This entry should never be changed by the system 
administrator or by a user. 

CMOS /usr/vpix/defaults/cmos 

This entry defines a file image of the CMOS informa¬ 
tion (definitions of the hardware on the system) nor¬ 
mally stored in the battery backup CMOS RAM (ran¬ 
dom access memory). 

This entry should never be changed by the system 
administrator or by a user. 

BOOTIMAGE $HOME/vpix/vpix.img 

This entry specifies the name of the VP/ix quickboot 
image file, which contains a fast-loading image of a 
user’s VP/ix Environment. This quickboot image is 
used to enter the VP/ix Environment (via the 
vpix -r command) without going through the DOS 
bootup sequence or to run a DOS application (such as 
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Lotus® 1-2-3® or dBASE™) directly from the UNIX 
shell prompt. 

This entry will never need to be changed. 

A, B /dev/rdsk/f0d9dt 

These entries map the standard DOS devices, A and B, 
to their respective counterparts in the UNIX environ¬ 
ment. For example, drive A, which is normally the 
first diskette drive in DOS, may be mapped to 
/dev/rdsk/f0d9dt, which is the UNIX device 
name for a double-density double-sided diskette drive. 
This allows a user in the VP/ix Environment to 
request a directory listing of this drive, using the DOS 
device name A :. If there is no entry for drive A in 
the user’s configuration file, a request for a directory 
listing of drive A will result in an error message simi¬ 
lar to this: 

General Failure error reading drive A 
Abort, Retry, Ignore? 

The VP/ix Environment will automatically determine 
the density of both the physical drive and the media 
inserted into it regardless of which UNIX device name 
(for double- or high-density) is used as the diskette 
device. For a more detailed discussion of UNIX dev¬ 
ices and UNIX device path names, see section 8 of 
“386/ix Maintenance Procedures.” 

Remove the semicolon from the beginning of the line 
containing the appropriate entry (depending on the 
type of drive you have and which drive you wish to 
assign to the user) to give the user access to that 
diskette drive. Note that if the user wants to boot 
DOS from the A drive instead of the C drive, he or she 
must: 

• have an A entry in his or her configuration file, 

• have a valid DOS boot diskette in the diskette 
drive to which A is mapped in that entry, and 

• invoke vp i x with the - b option, as described in 
the ypix(l) manual page. 
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D /dev/dsk/OpO 

If you have an actual DOS partition on your first fixed 
disk, you can access it under VP/ix in one of two 
ways. The preferred method is to mount it as part of 
the UNIX file system using the DOS-FSS facility 
described in Appendix A of the “UNIX Primer,” and 
access it through the Z drive as you would access any 
other UNIX file. Alternatively, you may map the D 
drive (normally the DOS partition on the second fixed 
disk in native DOS) to the UNIX device name for the 
first fixed disk, /dev/dsk/OpO. Note that this will 
only work if the user has UNIX read and/or write 
permissions on /dev/dsk/OpO. As this is not nor¬ 
mally desirable, this method of DOS partition access is 
not preferred. 

COM1,COM2 /dev/tty00,/dev/tty0 1 

These entries map DOS serial port names to the 
names of corresponding UNIX serial devices. Typi¬ 
cally, COM 1 is mapped to /dev/tty 0 0 or 
/dev/ttyO1 and COM2 is mapped to 
/dev/tty01. 

Remove the semicolon from the beginning of the line 
containing the COM1 entry if a user wishes to use an 
application that requires serial communication. To 
allow a user access to the second serial communica¬ 
tions port (if your computer has one) as well as the 
first, add the following entry to the configuration file: 

COM2 /dev/ttyO1 

COM2 must not be specified unless COM1 is also 
specified. If you want to only allow access to the 
second port, add the following entry: 

COM1 /dev/ttyO1 

Note that COM1 and COM2 are not supported on 
MULTIBUS™ systems and their entries should remain 
commented out on such systems. 

COM1MOUSE,COM2MOUSE /dev/ttyOO,/dev/ttyO1 
These entries should be used instead of COM1 and 
COM2 whenever the serial port is being used for a 
serial mouse. This will ensure proper mouse behavior 
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when switching among virtual terminals, as described 
below in the MOUSE entry. All the comments per¬ 
taining to COM1 and COM2 above apply here as well. 

MOUSE /dev/mouse 

This entry identifies the mouse pointing device. This 
entry is specifically for users who have a Microsoft® 
Inport-2 Bus mouse pointing device. It does not apply 
to serial pointing devices that use COM1 or COM2 and 
plug into your computer’s serial ports. (If you have 
such a mouse and wish to give a VP/ix user access to 
it, you must uncomment the appropriate COM1 or 
COM2 entry, depending on which serial port the 
mouse is plugged into.) The mouse device is not 
currently supported on MULTIBUS systems. 

Remove the semicolon from the line containing the 
MOUSE entry if the user has a Microsoft Inport-2 Bus 
mouse pointing device. Otherwise, this entry should 
not be modified. 

Note that the mouse is automatically released and 
reacquired whenever you leave or enter the virtual ter¬ 
minal running your VP/ix session. Thus, multiple 
VP/ix sessions may be run on different virtual termi¬ 
nals, and the mouse will automatically “follow along” 
when you switch among them. 

LPT1, LPT2, LPT3 /usr/bin/lp 

These entries map the standard DOS printer devices to 
the name of the UNIX printer spooler program. If 
different printers are available on your system, you 
may need to provide options to the spooler. For 
example, this entry maps LPT2 to a command that 
spools jobs for your laser printer: 

LPT2 /usr/bin/lp -dlsr 

LPT2 must not be specified unless LPT1 is also 
specified, and LPT3 must not be specified unless both 
LPT 1 and LPT2 are specified. 

Note that it will be necessary for the user to use the 
Flush Printer option on the VP/ix interface 
Menu to actually send text to the printer. Refer to 
the “VP/ix and MS-DOS Primer” for more 
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information about the printer spooler and the 
Flush Printer option on the VP/ix Interface 
Menu. 

Any line that begins with a keyword not listed here is assumed to be 
an Installable Emulation Module or a Direct Device Attachment. 
These facilities are described in detail in §6 of this document. An 
entry describing these devices can also be found in the file 
/usr/vpix/etc/vpixdevs. 

2.3 Summary of Recommendations for Resource Allocation 

• Make global configuration changes to the default vpix.cnf 
file in the /usr/vpix/defaults directory to ensure that 
all new VP/ix user accounts reflect the changes. 

• Determine which users need to customize their DOS environ¬ 
ments and provide those users with private copies of the C drive. 

• Allocate resources according to individual user’s needs as well as 
the physical proximity of users to resources. Edit each user’s 
vpix . cnf file accordingly. 

• Determine whether users will be allowed to modify their 
configuration information or whether the system administrator 
will retain control of all resource allocation. Assign permissions 
to the users’ vpix .cnf files accordingly. 

2.4 The VP/ix Resource Allocation Display 

When a user pops up the VP/ix Interface Menu, a secondary display 
box also appears to the right. 


VP/ix Version 1 . 1 

( ESC ) ape menu 
(F)loppy release 

(P) rinter flush 

(Q) uit VP/ix 

(R) eset VP/ix 

(S) ound OFF 

(C)lose serial 
(E)nter shell 


Device 

Assignment 

A: 

/dev/rdsk/fOql5dt 

C: 

/usr/vpix/defaults/C: 

Terminal 

Assignment 

AT 3 86 

/dev/console 


This is the simplest way to check precisely what devices are 
configured for the user, and that the user’s vpix.cnf file has 
been set up properly. The left-hand section of the display lists all of 
the DOS devices that have been activated in the user’s configuration 
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file and the actual UNIX device to which each DOS device has been 
mapped. If the user has released the device, for example, using the 
(F) loppy release or (C)lose serial options on the 
VP/ix Interface Menu, there will be no UNIX device name listed 
and the word released will appear instead. Should the user 
reacquire the device, for example by referring to the A drive in the 
case of the diskette, the UNIX device name will once again be 
displayed when the VP/ix Interface Menu is popped up. 

The right-hand section of the display indicates the value of the 
user’s TERM environment variable and the UNIX terminal device on 
which he or she is logged in. 
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3. CROSS-EXECUTION ENVIRONMENT 

The environment that allows a user to run a DOS program from 
UNIX and a UNIX program from DOS is called a cross-execution 
environment. Cross-execution is available to all VP/ix users. This 
section describes the VP/ix cross-execution environment and 
discusses the problems a user may encounter. In this section you 
will learn: 

• The importance of PATHS. 

• How to run UNIX programs from DOS. 

• How to run DOS programs from UNIX. 

• How to set up login environments. 

3.1 The Importance of PATHS 

A user can run a DOS program from the UNIX environment by 
changing to the directory in which the DOS program is located and 
executing the program. To execute a DOS program directly from 
the UNIX shell prompt without having to explicitly change to the 
directory in which it is located, the program must be located in a 
directory specified in a search path. A search path specifies a set of 
directories to be searched for an executable file or command. It is 
defined in the shell .profile file. (Refer to “386/ix Mainte¬ 
nance Procedures” for more information about the .profile 
file.) Two path variables are required in the VP/ix Environment, 
PATH and DOSPATH. PATH defines the directories to be searched 
for a UNIX-executable file. DOSPATH defines the directories to be 
searched for a DOS-executable file if a UNIX-executable file of the 
specified name is not found. The directories specified in DOSPATH 
must be a subset of the directories specified in the shell variable 
PATH, which is set in the user’s .profile file. The DOSPATH 
variable is automatically added to the user’s .profile file when 
the VP/ix user account is installed. 

If a user tries to execute the command dosprog from the UNIX 
environment, for example, the shell searches for the file dosprog 
in the first directory specified in PATH. If the shell finds a UNIX 
file by that name, it runs that file as an executable UNIX program. 
If no UNIX file by that name is found, the shell looks to see if that 
directory is also specified in DOSPATH. If it is not, the shell con¬ 
tinues the process with the next directory specified in PATH. How¬ 
ever, if the directory is also specified in DOSPATH, then the shell 
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searches for the equivalent DOS-executable file name in that direc¬ 
tory. The shell searches for the files dosprog.com, 
dosprog.exe, and dosprog.bat, in that order. (The 
suffixes .com, .exe, and .bat indicate DOS-executable files.) If 
it finds a file that matches the above specification in the directory in 
DOSPATH, the VP/ix Environment is quickbooted and the DOS 
command is run. 

For example, to execute DOS programs located in the directory 
/usr/bob/dosbin directly from the UNIX shell prompt 
without having to change to that directory, modify the DOSPATH 
and PATH variables in the user’s . prof ile file to look like this: 

DOSPATH=$DOSPATH:/usr/bob/dosbin 
PATH = $PATH:/usr/bob/dosbin 

The user can now run the dosprog program at the UNIX shell 
prompt from any directory. 

3.2 Running UNIX Programs From DOS (rununix . exe) 

The VP/ix Environment is designed to allow users to execute any 
UNIX command from the DOS under UNIX environment. When 
VP/ix is initially installed, a DOS program called rununix.exe 
is put into the directory /usr/vpix/unixbin. This program 
allows a user to execute UNIX commands (which are located in the 
UNIX directories /bin and /usr/bin) while using the VP/ix 
Environment. 

UNIX conventions must be used to run a UNIX command in the 
VP/ix Environment. Options must be specified with the UNIX dash 
(-) character instead of the DOS slash (/), and directory and file 
names must be separated with the UNIX slash (/) instead of the 
DOS backslash (\). 

3.2.1 How rununix . exe Works 

Each UNIX command located in the directories /bin and 
/usr/bin must have an equivalent DOS-executable file name 
associated with the program rununix. exe in order to run in the 
VP/ix Environment. DOS-executable file names are automatically 
created in the directory /usr/vpix/unixbin and linked to 
rununix.exe when VP/ix is first installed. 

Each DOS-executable file name must end in the suffix .exe. For 
example, the DOS-executable name for the UNIX command Is is 
Is . exe. Since they are linked, there is only one actual copy of 
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the file residing on the disk. The DOS-executable file name 
Is . exe is simply a link to the rununix. exe file. A link is a 
pointer to the original file; it is not a copy of the contents of the ori¬ 
ginal file. 

The system file /usr/vpix/unixbin/rununix. exe is 
available to all VP/ix users. Each VP/ix user is also provided with 
an individual copy of rununix. exe. When an individual VP/ix 
account is established, the system automatically creates the direc¬ 
tory vpix and the subdirectory vpix/unixbin in the user’s 
login ($HOME) directory. The system file 
/usr/vpix/unixbin/rununix. exe is copied to the user’s 
$ HOME/vpix/unixbin directory. The user has access to all of 
the UNIX commands linked to the system’s rununix. exe file in 
the directory /usr/vpix/unixbin and can also link personal 
UNIX programs and commands to an individual rununix.exe 
file. 

For example, Bob’s UNIX program unixprog is located in his 
bin directory, /usr/bob/bin. To use his unixprog pro¬ 
gram in the VP/ix Environment, an equivalent DOS-executable file 
name must be linked to the file 

/usr/bob/vpix/unixbin/rununix. exe. This can be 
done from either the VP/ix Environment or the UNIX shell with this 
command: 

$ In /usr/bob/vpix/unixbin/rununix.exe /usr/bob/vpix/unixbin/unixprog.exe 

The unixprog command is now available in Bob’s environment. 

Note that in order for a UNIX program to be executable in the 
VP/ix Environment, the DOS-executable name of the program must 
be located in a directory specified in the user’s DOS path (set in the 
autoexec.bat file) and the actual UNIX command must be 
located in a directory specified in the user’s UNIX path (set in the 
PATH variable in .profile). Thus, in this example, 
/usr/bob/vpix/unixbin has been placed in Bob’s DOS path 
when he started up VP/ix, and /usr/bob/bin was, presumably, 
put in his UNIX path when he logged into UNIX. Also note that 
the user must give his UNIX command a name that is a legal DOS 
file name (without an extension) in order to be able to access it 
while under VP/ix. Thus the command name must have eight or 
fewer characters and contain no uppercase letters or dots (.). 
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3.3 Running DOS Programs From UNIX 

It is not necessary to enter the VP/ix Environment in order to run a 
DOS command. The VP/ix installation procedures automatically 
create an environment in which a user can run a DOS program, 
located in the user’s current directory, from the UNIX shell prompt. 
For example, if the DOS application Lotus 1-2-3 is located in the 
directory /usr/dos/12 3, it can be run directly from the UNIX 
shell prompt in this way: 

$ cd /usr/dos/123 
$ 123 

A user can run DOS programs from other directories if the 
DOSPATH and PATH shell variables located in the user’s 
$HOME/ . prof i le file are correctly modified and exported. 
Refer to §3.1. 

3.4 Setting Up Login Environments 

Under VP/ix, a user normally logs into the UNIX environment and 
then executes the vpix program to access the VP/ix Environment. 
However, it is possible for a user to instead be placed directly in the 
VP/ix Environment or in a DOS application at login. 

3.4.1 Setting Up a VP/ix Login Shell 

You can set the vpix program to be a user’s login shell by modify¬ 
ing the UNIX file /etc/passwd. Use the moduser option 
from the sysadm User Management submenu to change the user’s 
login shell. Select the option called chgshell and change the 
user’s login program to /usr/bin/vpix. A user whose login 
shell is vpix is placed immediately in the VP/ix Environment at 
login. Upon exiting the VP/ix Environment, the user also exits 
UNIX and a new login prompt appears on the screen. Refer to sec¬ 
tion 5 of “386/ix Maintenance Procedures” or refer to the 
Operations/System Administration Guide if you require more infor¬ 
mation on how to set another program to be the login shell of a 
user. 

3.4.2 Setting Up a DOS Application as the Login Environment 

Some users may want to be placed in a DOS application environ¬ 
ment, such as Lotus 1-2-3, when they log in. You cannot make this 
application the user’s login shell because the DOS application is not 
an executable UNIX program. If you wish to place a VP/ix user 
directly into a DOS application upon login to UNIX, you must 
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modify the user’s .profile file to execute the DOS application 
from UNIX and then log out. For example, to have a user log in 
directly to Lotus 1-2-3, which is installed in the UNIX directory 
/usr/dosapp/12 3, add the following lines to the end of the 
user’s . prof i 1 e file: 

cd /usr/dosapp/123 

123 

exit 

When the user logs in, the DOS application in the file 12 3 will be 
executed. When the user exits this application, UNIX is also exited 
and a new login prompt appears on the screen. 
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4. TROUBLESHOOTING 

The VP/ix Environment allows you to run the DOS and UNIX 
operating systems concurrently. Each system operates under a 
unique set of rules and conventions, although there is some overlap 
between the two systems. 

Common problem areas include: 

• The use of special characters (\, *, ?). 

• The use of upper- and lowercase characters. 

• Attempts to access programs from the wrong directory. 

• Execution errors while running a DOS application. 

• Attempts to list the C drive. 

• Problems with the mouse device. 

• Problems accessing the diskette drive. 

• Problems with the VP/ix Interface Menu. 

This section describes some of the most common problems areas and 
suggests some corrective actions. 

4.1 Special Characters and VP/ix 

The UNIX shell interprets commands and performs expansion 
differently from the DOS command processor. The UNIX directory 
separator / is the DOS switch character. A user might type the fol¬ 
lowing in an attempt to execute the DOS command chkdsk. com 
from UNIX: 

$ chkdsk/f a: 

Instead of executing the command, however, the UNIX shell inter¬ 
prets the / character as a directory separator and searches for a file 
named f in the directory chkdsk. 

The UNIX shell also expands wildcard characters, such as * and ?, 
and uses the \ as an escape character. However, the DOS com¬ 
mand processor uses the \ as a directory separator and leaves the 
expansion of the wildcard characters to the DOS system itself. 

To avoid the problems inherent in these differences, arguments to 
DOS commands that are running from the UNIX shell should be 
enclosed in single quotes. For example: 
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$ chkdsk '/f a: ' 


or 

$ copy '*.c a:\srcdir\cdir' 

The UNIX shell does not interpret arguments within single quotes, 
so they are passed on correctly to the VP/ix Environment when it 
quickboots. 

4.2 Problems With Upper- and Lowercase Letters 

The UNIX shell differentiates between lower- and uppercase letters, 
but the DOS command processor maps everything to uppercase 
letters before passing it to the DOS system. UNIX users usually use 
lowercase letters to name files, and DOS files located in the UNIX 
file system are stored with their names in lowercase. As a general 
rule, therefore, it is simpler to use lowercase letters when in the 
VP/ix Environment. However, if a UNIX command requires that 
an argument or option be specified in uppercase letters, then the 
argument or option must be typed in uppercase at the VP/ix com¬ 
mand line. 

4.3 Accessing a Program From the Wrong Directory 

Some DOS programs, such as WordStar™, search for files in the 
current directory. Attempting to execute these programs from a 
directory other than the directory in which they are installed will 
result in error messages. While running such DOS programs from 
UNIX, the user must be in the directory in which these programs 
are installed. 

4.4 Execution Errors While Running a DOS Application 

VP/ix will run most DOS applications. However, there are some 
“ill-behaved” DOS programs that use nonstandard devices or port 
addresses. These programs may cause problems in the VP/ix 
Environment. If the program you are attempting to run does not 
function correctly, check the file /usr/vpix/README. This file 
contains a list of problems that are generated when some DOS appli¬ 
cations are run under VP/ix. If the problem does not appear in this 
list, try to determine whether the application runs properly under 
native DOS. If it does, notify your VP/ix vendor of the problem. 

4.5 Attempting to List the C Drive 

The DOS image file /usr/vpix/def aults/C: (or 
$HOME/vpix/C:, if the user has a personal C drive image) is a 
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single UNIX file containing the physical image of a DOS file system. 
A user cannot obtain a UNIX-style listing of the files on the C drive 
by using the Is command because the command cannot “see” the 
files inside C. To list the C drive from within the VP/ix Environ¬ 
ment, use the DOS dir command. 

4.6 Problems With Mouse Response 

The mouse pointing device is not currently supported on MULTIBUS 
installations. If have a MULTIBUS system, you may skip this 
section. 

If a user has installed an application that uses a mouse as the point¬ 
ing device and the mouse does not work with the application, follow 
these steps: 

1. Make sure that the mouse was specified as the pointing device 
during the DOS application installation. 

2. Make sure that a driver for the mouse has been configured 
into your UNIX system (refer to “386/ix Maintenance Pro¬ 
cedures” for information about configuring the kernel to sup¬ 
port new devices). 

3. Make sure that an entry for the mouse appears and is not 
released in the display section of the VP/ix Interface 
Menu. If you are using a Microsoft Inport Bus Mouse, there 
should be a MOUSE entry; if you are using a serial mouse, 
there should be a COM1 entry. If no entry is present, check 
the user’s vpix. cnf file and alter it as described in §2.2. 

4. Make sure that the mouse is properly plugged into the correct 
device. 

4.7 Problems Accessing the Diskette Drive 

If a user is not able to access the diskette drive from the VP/ix 
Environment, follow these steps: 

1. Pop up the VP/ix Interface Menu and check the existence of 
an entry for the drive the user is trying to access (A or B). If 
the entry does not exist, alter the user’s vpix. cnf file as 
described in §2.2. 

2. If the entry is there but is marked released, and this error 
message is generated when trying to access the device, it 
means that vpix could not obtain exclusive access to the 
diskette device: 
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General Failure error reading drive A 
Abort, Retry, Ignore? 

This can be caused by: 

— Another user who has accessed the diskette drive from 
VP/ix and has not released it. The other user can release 
it by using the (F) loppy Release option on the 
VP/ix Interface Menu or by exiting the VP/ix Environ¬ 
ment. 

— The user does not have access permission for the diskette 
drive. Make sure the diskette device file to which you 
mapped the DOS A or B drive has read and write permis¬ 
sions for all users. 

4.8 Problems With the VP/ix Interface Menu 

If a user invokes the VP/ix Interface Menu from the VP/ix Environ¬ 
ment while in a DOS graphics application, the menu is not visible. 
However, the keystrokes used to select the menu options will con¬ 
tinue to operate. To return to the VP/ix Environment, use lESCl . 
To exit the VP/ix Environment, type q. 

4.9 Problems With Printer Output 

It is possible for a VP/ix user to request printer output using either 
an application’s printing facilities or the DOS print command, to 
flush the printer from the VP/ix Interface Menu, and to have only 
part of the job appear when printed. When the user flushes the 
printer again, the rest of the job will appear. The problem is that 
the user does not know when the application or DOS has completed 
“printing,” thus making the full job available for the real UNIX 
print spooler. 

Instruct the user to simply wait longer before flushing the printer 
(or exiting the VP/ix Environment). A rule of thumb is that he or 
she should wait 1 minute per 15,000 bytes (about two pages) of 
print job before flushing the printer. 
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5. DOS AND DOS FILES IN THE VP/ix ENVIRONMENT 

The VP/ix Environment is distributed with an enhanced version of 
MS-DOS that is designed to work specifically with VP/ix. This sec¬ 
tion describes: 

• The enhanced version of DOS distributed with VP/ix. 

• The DOS files that are specific to the VP/ix Environment. 

It is intended for system administrators who are very familiar with 
the standard DOS environment. 

5.1 DOS in the VP/ix Environment 

The version of DOS supplied with the VP/ix installation has been 
modified to run more efficiently in the VP/ix Environment. Changes 
were made to improve performance and do not alter the functional¬ 
ity of DOS in any way. Note that any “off the shelf’ version of 
DOS will run under VP/ix, although not as efficiently as the version 
supplied with the VP/ix Environment. For more information about 
the modifications made to this version of DOS, refer to the VP/ix 
Technical Guide. 

5.2 DOS Files in the VP/ix Environment 

Some of the DOS files that are distributed as part of the installation 
are specific to the VP/ix Environment. These files are used by the 
system and should not be altered by the user. Each VP/ix-specific 
file is described in the following subsections. 

5.2.1 The Redirector Program 

redir.exe is a DOS program that allows other DOS programs to 
access the UNIX file system. It is also called the redirector. 
redir . exe should be run from autoexec . bat. 

5.2.2 Running DOS Commands From UNIX 

rundos . com is a DOS program that facilitates the execution of 
other DOS programs from UNIX. One of its functions is to help 
save and fast load a DOS image. This should be the last program 
executed in the autoexec .bat file; any programs executed after 
this program will not be included in the DOS environment after a 
fast load operation. 
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5.2.3 Running UNIX Commands From DOS 

rununix. exe is a DOS program that facilitates the execution of 
UNIX programs from DOS. This file is described in greater detail 
in §3. 

5.2.4 Expanded Memory Standard Driver 

ems.sysisa DOS-loadable device driver that allows access to the 
“Expanded Memory Specification” (EMS) as defined by Lotus- 
Intel®-Microsoft (LIM), version 3.2. It can be used by certain DOS 
applications to partially circumnavigate the limitation known as the 
“640K barrier.” (DOS normally prevents programs from accessing 
memory addresses beyond 640K.) If the EMS.SYS driver has been 
loaded, part of the virtual address space available to the UNIX sys¬ 
tem will be dedicated to the VP/ix process. Only a small number of 
DOS applications are written to take advantage of EMS 3.2. 

Up to 2 MB of LIM 3.2 expanded memory (EMS) are available 
under VP/ix. 

In a multi-user environment it is not recommended that EMS be 
configured for the communal C: drive in 

/usr/vpix/defaults. This is because unnecessary use of 
EMS greatly reduces system performance, and reduces the max¬ 
imum number of VP/ix processes that can be run at one time. 

To install this driver, a user must add the following line to his or 
her conf ig . sys file: 

device=ems.sys Sx 

The S argument modifies the amount of EMS assigned to the partic¬ 
ular user, and x is the number of 16K memory pages to be assigned. 
The maximum of value of x is 128, which dedicates 2 MB of EMS 
to the user. 

Here is the procedure for using EMS: 

1. If the person who needs access to EMS memory has already 
been added as a VP/ix user with his own copy of the C drive, 
go to step 6. 

2. Login as the user who needs EMS (who must already have 
been added as a VP/ix user). 

3. Type cp/usr/vpix/def aults/C : $HOME/vpix 
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4. Type chmod 644 $HOME/vpix/C : 

5. Edit the file $HOME/vpix/vpix. cnf, replacing 
/usr/vpix/def aults/C : with $HOME/vpix/C : 

6. Boot VP/ix. 

7. Type COPY Z : \USR\VPIX\DOSBIN\EMS . SYS C : \ 

8. Type 

COPY C:\CONFIG.SYS + CON: C:\CONFIG.SYS 

9. Type Device = ems . sys s 30 

10. Press I CTRL I Z. 

11. Press ICTRLI IalTI [DEL] to reboot VP/ix. 

12. The EMS driver will print a herald as you reboot, and the 
installation is complete. 

In step 9, the amount of expanded memory assigned to this user is 
configurable. After the s parameter, a value from 1 to 128 will 
specify the number of 16K EMS memory pages to assign. For 
example, s 30 will provide for 480K of expanded memory. This is 
the maximum value recommended on systems with only 2 MB of 
physical (real) memory. 

The EMS memory space is used only for program data, and only by 
those few DOS applications that were specifically designed to take 
advantage of EMS 3.2. In the future, EMS 4.0 will be supported. 

5.2.5 Facilitating Redirector Access 

dosmount. exe is a DOS file that works in conjunction with the 
redirector and allows the mapping of a DOS drive name to any 
directory in the UNIX system. It also allows you to deactivate or 
reactivate the redirector and change the DOS host name. For usage 
details, type dosmount at the VP/ix prompt. 
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6 . ACCESSING NONSTANDARD DEVICES IN THE VP/ix 
ENVIRONMENT 

VP/ix is pre-configured to support certain “standard devices,” such 
as diskette drives and fixed disks, serial ports (COM1 and COM2), 
and printer ports (LPT1 and LPT2). Other devices are classified as 
“nonstandard.” Examples of nonstandard devices that you may want 
to install at some point include networking cards, a tape drive, or an 
unsupported type of mouse. 

If you have a standard hardware configuration, you will not 
need any of the information in this section. You should not 
attempt to install a nonstandard device unless you have some 
understanding of hardware and system configurations. This 
section does not attempt to explain all the harware-related con¬ 
cepts necessary to fully understand the procedures discussed 
here. 

This section describes how VP/ix accesses nonstandard devices and 
explains how to make nonstandard devices accessible to the VP/ix 
user. Specifically, it describes: 

• The difference between IEM and DDA devices. 

• The function of the vpixdevs file. 

• How to configure nonstandard devices into VP/ix. 

• How to make nonstandard devices accessible to VP/ix users. 

• How to modify the configuration parameters for nonstandard 
devices. 

• How to remove nonstandard devices from the VP/ix 
Environment. 

6.1 IEM and DDA Devices 

VP/ix supports two different types of nonstandard devices: Direct 
Device Attachment (DDA) devices and Installable Emulation 
Module (IEM) devices. DDA devices are accessed directly by VP/ix 
in exactly the same manner as under native DOS. IEM devices are 
emulated ; that is, VP/ix does not access them directly, but does so 
through a piece of software called an Emulation Module that is 
configured into VP/ix, and a corresponding UNIX device driver. 

DDA devices are typically supplied with a DOS device driver (often 
called name, sys) that must be installed into users’ 
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config.sys files. DOS application programs access the device 
through the device driver, which accesses the hardware directly. 

Any device that functions in a standard PC may potentially be 
installed as a DDA device. The principal restriction is that devices 
that use DMA (for example, many network cards) may not be 
configured into the VP/ix Environment as DDA devices. Consult 
your 386/ix™ vendor for further information. 

IEM devices are more complex, but easier to install. They are typi¬ 
cally supplied by the hardware manufacturer or 386/ix vendor with 
Emulation Module software and a UNIX device driver specifically 
tailored for the VP/ix Environment. The device emulation software 
used by IEM devices must be configured into the vpix program, 
and the additional UNIX device driver must be configured into the 
UNIX kernel. (Note that VP/ix’s support for the Microsoft Bus 
Mouse is provided by means of an IEM called bmouse.) As with 
DDA devices, DOS application programs access the device through 
the DOS device driver, but this driver does not access the hardware 
directly. Instead, its actions are intercepted and interpreted by the 
Emulation Module, which communicates with the UNIX device 
driver responsible for accessing the hardware. 

While DDA devices require less software support than IEM devices, 
they are not as powerful, because they may be accessed by only one 
user at a time. IEM devices, because their control software is writ¬ 
ten specifically for VP/ix, may be shared by several users. 

6.2 The vpixdevs File 

All nonstandard devices known to VP/ix are defined in the file 
/usr/vpix/etc/vpixdevs. Although this is a text file, it 
should never be edited directly; instead it should be modified using 
the options available on the sysadm VP/ix Management submenu. 

The vpixdevs file contains eight fields, but not all fields are 
necessarily used for each device. Consult your hardware 
manufacturer’s documentation to determine which fields are neces¬ 
sary for your particular device. The vpixdevs file contains the 
following fields: 

• The device’s logical name (the name used by VP/ix users in their 
vpix. cnf files). 

• The name of the IEM associated with the device. 
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• The name of the UNIX device special file associated with the 
device. 

• The Interrupt ReQuest level (IRQ) used by the device. 

• The range of I/O addresses used by the device. 

• The range of controller memory used by the device. 

• The DMA channel used by the device. 

• A configuration flag specifying whether the device has been 
configured into vpix (and hence, whether it is accessible by 
VP/ix users). 

Devices that are defined in vpixdevs are said to be “registered” 
with VP/ix. Note that it is possible for a device to be registered but 
still inaccessible, if the value of its configuration flag is N. The 
values of this and other fields are modified using the vconfig 
option on the VP/ix Management submenu of the System Adminis¬ 
tration menu described in §6.5. 

6.3 Configuring Nonstandard Devices Into the VP/ix Environment 

All devices must be physically installed into the computer before 
they can be configured into the VP/ix Environment. In order to 
physically install a device, you should shut down the system and 
then follow the installation instructions provided by the device’s 
manufacturer. Once the system has been rebooted, you will follow 
one of the procedures described below, depending on whether you 
have an IEM or a DDA device. 

6.3.1 Configuring IEM Devices into the VP/ix Environment 

The software support for IEM devices is provided on a diskette that 
should be installed using the installpkg option of the sysadm 
Software Management submenu. The installation procedure is com¬ 
pletely automatic and will require no intervention unless some of the 
device configuration parameters (for example, the IRQ level) conflict 
with those used by one of VP/ix’s standard devices. If such a 
conflict occurs, the installpkg program will display a warning 
message. If this occurs, you will need to reconfigure the device’s 
board according to the instructions provided by the manufacturer 
and then rerun the installation procedure. 

It is also possible that the device’s configuration parameters could 
conflict with those of another IEM or DDA device that you have 
already installed. In this case you might want to reconfigure the 
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board if possible, in order to remove the conflict. If you do so, you 
will need to select the vconf ig option from the sysadm VP/ix 
Management submenu in order to specify to VP/ix the new parame¬ 
ters for that device. Refer to §6.5 for more information on how to 
do this. 

6.3.2 Configuring DDA Devices Into the VP/ix Environment 

DDA devices are more difficult to configure into the VP/ix Environ¬ 
ment than IEM devices, and there is more opportunity for error. Do 
not attempt to add a DDA device unless you fully understand the 
device configuration parameters discussed below. 

Once the DDA device has been physically installed in the system, 
you must tell VP/ix how it is configured. Depending on the device, 
you will need to specify one or more of the configuration parameters 
listed below. (Note that devices that use DMA, such as many net¬ 
working cards, cannot be accessed under VP/ix as DDA devices.) 
Configuration parameters that may be necessary are: 

• The Interrupt ReQuest level (IRQ) used by the device. 

• The range of I/O addresses used by the device. 

• The range of controller memory used by the device. 

• The name of the UNIX special device file associated with the 
device. 

Refer to the documentation supplied with the device for the neces¬ 
sary information for specifying these parameters. If insufficient 
information is available, consult your hardware manufacturer. 

Access the System Administration main menu and select option 4, 
packagemgmt. When the Package Management menu appears, 
select the option called vpixmgmt. You screen will look similar 
to this: 
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-v 



VP/ix MANAGEMENT 


1 

addvpixuser 

enable users to use the VP/ix Environment 


2 

delvpixuser 

disable users from using the VP/ix Environment 


3 

ddainstall 

install a DDA device into the VP/ix Environment 


4 

ddaremove 

remove a DDA device from the VP/ix Environment 


5 

vconf ig 

change device parameters and reconfigure VP/ix 



Enter a number 

, a name, the initial part of a name, or 



? or <number>? 

for HELP, q to QUIT: 







Select option 3, ddainstall. This program prompts for a logi¬ 
cal name for the device. It then displays a menu that allows you to 
specify the IRQ level, I/O range, and controller memory range used 
by the device, and the name of the UNIX special device file associ¬ 
ated with the device. If the device uses interrupts, I/O ports, or 
contains controller memory, you must specify this information here, 
otherwise you will not be able to access the device in the VP/ix 
Environment. 

Once you have specified the device’s configuration parameters and 
have finished going step-by-step through the procedure, the device 
may be accessed by VP/ix users. See §6.4 for further information. 

6.4 Making Nonstandard Devices Accessible to VP/ix Users 

Once an IEM or DDA device has been configured into the VP/ix 
Environment as described above, individual users may access it by 
placing its logical name in their vpix.cnf files. In the case of 
DDA devices, only the logical name is required. For example, if you 
have added a networking card to your computer, with the logical 
name NETCARD, add the bottom line to your vpix. cnf file: 

; VP/ix Configuration File 


DOS DEVICE 


UNIX DEVICE PATH NAME 


C 

ROM 

EGAROM 

VGAROM 

CMOS 

BOOTIMAGE 

NETCARD 


/usr/vpix/defaults/C: 
/usr/vpix/defaults/rom 
/usr/vpix/defaults/romega 
/usr/vpix/defaults/romvga 
/usr/vpix/defaults/cmos 
$HOME/vpix/vpix.img 


Certain IEM devices may require an additional parameter to be 
specified; consult the documentation supplied with the device 
for details. 
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6.5 Modifying the Configuration Parameters for Nonstandard 
Devices 

Sometimes it is necessary to modify the configuration parameters of 
nonstandard devices (perhaps because they conflict with those of a 
new device, and it is more convenient to change the old device). 
Under these circumstances the vconf ig command, which may be 
accessed via the sysadm vpixmgmt option, may be used to 
redefine the device’s parameters. See the vconfigi 1) manual page 
for full details of this command. 

6.6 Removing Nonstandard Devices From the VP/ix Environment 

You may remove IEM or DDA devices temporarily or permanently. 
If you want to make a device temporarily unavailable to VP/ix 
users, it is not necessary to remove it completely from the VP/ix 
Environment. Use the vconf ig option from the VP/ix Manage¬ 
ment submenu (see §6.5) to set the value of the Configuration Flag 
to N. Devices that have been “disabled” in this way may be re¬ 
enabled in the future simply by using vconf ig to set the value of 
the Configuration Flag back to Y. 

To permanently remove an IEM device from the VP/ix Environ¬ 
ment, use the removepkg option of the sysadm Software 
Management submenu. It will guide you step-by-step through the 
procedure. Refer to “386/ix Maintenance Procedures” for more 
information about the removepkg option. 

To permanently remove a DDA device, use the ddaremove menu 
option from the sysadm VP/ix Management submenu. Enter the 
logical name of the device you wish to remove and the removal will 
proceed automatically. 

Once either type of device has been removed from the VP/ix 
Environment, it may be physically removed from the computer by 
following the manufacturer’s instructions. 
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Appendix A: USING VP/ix ON SERIAL TERMINALS 
1. INTRODUCTION 

The VP/ix Environment runs on many serial terminals. However, if 
you want to add an unsupported serial terminal to the VP/ix 
Environment or alter the default mappings in the terminal 
configuration file, you should read this appendix; otherwise, you may 
skip this section. 

To find out whether your terminal is supported by the VP/ix 
Environment, check the /usr/vpix/term directory. This 
directory contains a file for each supported terminal. For example, 
the file for the VT100™ terminal is /usr/vpix/term/vt 1 0 0. 

1.1 Terminal Requirements 

Any terminal that you add to the VP/ix Environment must have 
these basic features: 

• A display of at least 24 rows and 80 columns. 

• Direct cursor addressing, that is, there must be an escape 
sequence that allows the cursor to be moved to an arbitrary row 
and column on the screen. 

• A non-autowrap mode in which writing a character in column 80 
does not automatically advance the cursor to column 1 of the 
next row. 

• Escape sequences for line insertion and deletion or for setting 
the scrolling region and reverse scrolling (the VT100 terminal, 
for example, has these escape sequences). 

• An escape sequence for clearing the screen. 

Note that most terminals are equipped with these features. 

The following features are not necessary, but are highly desirable 
for running VP/ix because they add significantly to the illusion of 
being logged into a PC console: 

• A PC-compatible mode that can be entered and exited via escape 
sequences sent from the computer. This feature allows the 
entire PC character set to be displayed. A terminal with a PC- 
compatible mode also provides a 25-line display, a keyboard that 
is identical to a PC keyboard, and all of the screen attributes 
available on a PC. 
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• A number of “extra” keys, such as function keys and cursor 
arrow keys, in addition to the basic ASCII set. Extra keys are 
particularly important in the absence of a PC-compatible mode 
because they allow convenient mapping to PC keyboard keys. 

• A 25-line display. A standard PC display has 25 lines, and 
many PC applications use this feature. On standard terminals 
with only 24 lines, support is provided for “rocking” the terminal 
screen up and down to show either the first or the last 24 lines of 
the true screen. 

• Screen attributes, such as bold intensity, blinking, reverse, 
underline, and invisible modes. These allow a variety of applica¬ 
tions that use various screen attributes to be displayed correctly. 

1.2 Before You Begin 

This appendix assumes that you have a thorough understanding of 
the following: 

• The ASCII character set (refer to the Programmer’s Reference 
Manual). 

• The term info database (refer to terminfo( 4) or the 
Programmer’s Reference Manual. 

• Terminal escape sequences (refer to terminfo{ 4) and the termi¬ 
nal hardware manual provided with your terminal). 

Be sure that you have read and understood the appropriate docu¬ 
mentation before you attempt to add a serial terminal to your VP/ix 
Environment. 
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2. WHERE TERMINAL DESCRIPTIONS ARE LOCATED 

The VP/ix Environment uses the standard UNIX shell variable 
TERM to determine a user’s terminal type. Four sources are 
scanned for the necessary terminal information. Information 
specified in a later source overrides information collected from an 
earlier source. The sources are given below, in the order in which 
they are scanned. 

1. The first source scanned is the standard UNIX terminfo 
database. This is a UNIX database that describes what a ter¬ 
minal is and contains files for each supported terminal. 

2. The second source scanned is the VP/ix terminal-independent 
configuration file, /usr/vpix/term/sys. default. 
This file provides some default, VP/ix-specific terminal 
information. 

3. The third source scanned is the VP/ix terminal-specific 
configuration file located in the directory 
/usr/vpix/term. The name of this file is the same as 
the value of the user’s TERM variable. This file provides a 
specific terminal description. If no such file is found, the file 
generic is used. This file provides a set of default key¬ 
board mappings, output character mappings, and special key 
definitions usable on even the simplest terminals. These map¬ 
pings are described in “Appendix A: USING ASCII TERMI¬ 
NALS” of the “VP/ix and MS-DOS Primer.” No special capa¬ 
bilities of the user’s terminal will be taken advantage of. 

4. The fourth source scanned is an optional, individual override 
file, located in the directory specified in the shell variable 
VPIXTERMDIR. The name of the override file must also be 
the same as the value of the user’s TERM variable. This file 
allows a user to override the specifications in the system-wide, 
terminal-specific configuration file located in 
/usr/vpix/term. 

For example, if Bob’s TERM variable has the value vtlOO and his 
VPIXTERMDIR variable has the value /usr/bob/vpixterm, 
VP/ix scans these files in order: 

• /usr/1ib/terminfo/v/vt100 

• /usr/vpix/term/sys.default 
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• /usr/vpix/term/vt100 

• /usr/bob/vpixterm/vt100 

The last three files listed have a similar format, which is described 
in §3 of this appendix. 

The UNIX file in the terminfo directory is scanned using the 
standard UNIX curses library. (Refer to curses{ 3x) for more infor¬ 
mation.) The terminfo database contains information about 
various types of terminal capabilities (refer to terminfo{4) for 
details). If a file for the user’s terminal is not contained in this 
database or if the terminfo database is not installed on the sys¬ 
tem, you must define these capabilities either in the VP/ix 
terminal-specific configuration file or in the individual’s override file. 
§3 of this appendix lists the capabilities that must be defined for a 
terminal in the VP/ix Environment. 
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The VP/ix Environment must be provided with three types of infor¬ 
mation about a terminal: 

• Escape sequences or other information concerning terminal 
capabilities. 

• Mappings from ASCII input sequences to scan code sequences. 
(Scan codes are discussed in §3.2 of this appendix.) 

• Mappings from PC output characters to ASCII sequences. 

Information on escape sequences is contained in the UNIX 
terminfo files, which is why the appropriate terminfo file is 
scanned by VP/ix. However, it is possible to specify all of the infor¬ 
mation needed by VP/ix in the VP/ix terminal configuration file for¬ 
mat. Actual examples of configuration files can be found in the 
directory /usr/vpix/term. This is an example of a simple 
configuration file, illustrating each of the three types of terminal 
information listed above: 

* Comment lines begin with an asterisk. 

* Tokens are separated by white space. 

* The following line defines a terminal 

* capability; it has the form "capname: definition", 

* where the definition is terminfo-compatible. 

clear: \E[H$<10> * ANSI clear screen with 10 millisecond delay 

* The following line is an input ASCII to scancode 

* mapping definition; it maps the VT100 up-arrow key 

* to the PC keyboard up-arrow scancodes. 

input: \0 3 3-[-A 48-C8 

* The following line is a PC output to ASCII sequence 

* mapping. 

output: \001 O * map smiley-face to an O 

The following sections discuss the three types of terminal 
information. 

3.1 Terminal Capabilities 

The following standard UNIX terminfo capabilities are used by 
VP/ix. Note that only the required capabilities discussed in §1 of 
this appendix must be specified. (These are preceded by a “+” in 
the following list.) However, if you wish to increase display 
efficiency or increase the accuracy of the PC emulation, you should 
specify all terminal capabilities in the appropriate configuration file 
located in the /usr/vpix/term directory. 
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clear 

clear screen and home cursor 


ed 

clear to end of screen 


el 

clear to end of line 

+ 

csr 

change scrolling region (vtlOO only) 


ri 

scroll screen down one line 


ind 

scroll screen up one line 


indn 

scroll screen up n lines 

+ 

ill 

insert one line (non-vtlOO only) 


il 

insert lines (non-vtlOO only) 

+ 

dll 

delete one line (non-vtlOO only) 


dl 

delete lines (non-vtlOO only) 


ichl 

insert one character 


ich 

insert characters 


dchl 

delete one character 


dch 

delete characters 

+ 

cup 

position cursor 


home 

move cursor home 


cubl 

move cursor left 


cufl 

move cursor right 


cuul 

move cursor up 


cudl 

move cursor down 


In addition, the following capabilities are specific to VP/ix. Note 
that although the first six of these have the same name as a 
corresponding UNIX term info capability, the definitions are 
slightly different. Each of these capabilities are described more 
fully below. 

Screen Attribute Definitions 


sgrO 

normal mode 

blink 

blink mode 

bold 

bold mode 

rev 

reverse video mode 

invis 

invisible mode 

smul 

underline mode 

blbo 

blink+bold mode 

blr 

blink+reverse mode 

blu 

blink+underline mode 

bor 

bold+reverse mode 

bou 

bold+underline mode 

blbor 

blink+bold+reverse mode 

blbou 

blink+bold+underline mode 
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I 


i 


Svpix and Fvpix Sequences 

svpix VP/ix startup string 

fvpix VP/ix shutdown string 


Special Key Sequences 

k up up “rocker” sequence for 24-line terminals 

k_down down “rocker” sequence for 24-line terminals 

k_refr refresh sequence 


pccompat PC-compatible terminal 

c_xon XON character for PC-compatible terminal 

c_xoflf XOFF character for PC-compatible terminal 


3.1.1 Screen Attribute Definitions 

All of the screen attributes listed may be turned on. Although the 
first six attributes have the same name as the corresponding UNIX 
terminfo capability, the definitions are different. The remaining 
seven definitions do not exist in the UNIX terminfo information. 
Therefore, if your terminal supports any of these 13 attributes, you 
should define them in the appropriate VP/ix-specific configuration 
file in the /usr/vpix/term directory. 

The blink attribute illustrates the difference between the 
terminfo and the VP/ix way of defining attributes. The 
terminfo blink means “turn on blinking without changing any 
existing attributes.” Therefore, if reverse video is already on, it will 
remain on. However, the VP/ix blink means “turn on blinking and 
turn off all other attributes.” Therefore, if reverse video is on, it will 
be turned off. (On an ANSI standard terminal, the terminfo 
blink is defined as \E [ 5m, and the VP/ix blink is defined as 
\E[Q;5m). The other 12 definitions listed operate in the same 
way, that is, they turn on the specific attribute(s) while turning off 
all other attributes. 


3.1.2 The svpix and fvpix Sequences 

When you enter the VP/ix Environment or run a UNIX command 
from VP/ix, the svpix (start VP/ix) sequence is output to the termi¬ 
nal. When you leave the VP/ix Environment or leave a UNIX sub¬ 
shell from VP/ix, the fvpix (finish VP/ix) sequence is output to the 
terminal. This allows you to specify an arbitrary set of escape 
sequences for turning on and off any terminal modes that are 
appropriate under UNIX but not under VP/ix. It is suggested that 
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the following escape sequences (or similar escape sequences) be 
specified in the svpix and fvpix lines of the configuration file: 

• Turn off auto wrap mode when entering VP/ix and turn on 
autowrap mode when exiting VP/ix: under VP/ix, a screen emu¬ 
lating a PC must not automatically wrap and/or scroll when a 
character is written in column 80. It is only necessary to specify 
this escape sequence if the autowrap mode on your terminal is 
normally on. 

• Make the cursor a blinking underscore upon entering VP/ix (if 
you wish to emulate the cursor on a PC). Make the cursor a 
solid block when exiting VP/ix. 

• Upon entering VP/ix, turn on PC-compatible mode if you are 
using a PC-compatible terminal. (This escape sequence must be 
set if you are using a PC-compatible terminal.) Turn off PC- 
compatible mode when exiting VP/ix. 

• Reset all attributes to your normal UNIX setup upon exiting 
VP/ix. 

Here is an example of the svpix and fvpix lines contained in the 
wyse configuration file: 

svpix: \E'7\E~5$<3000>\Evl\E.3 

fvpix: \Ev4$ <6>\Ed*\EO$ <6>\Ee(\E'5 

The svpix string specifies “make the default attribute dim, go into 
PC-compatible mode, wait 3 seconds, turn enhance mode on, make 
cursor a blinking line.” The fvpix string specifies “go out of PC- 
compatible mode, wait 6 milliseconds, set autopage off, set autos¬ 
croll off, wait 6 milliseconds, set screen to 24 lines, make cursor a 
blinking block.” Note that in this case there is no need to specify 
autowrap mode off in the svpix line, because turning on PC- 
compatible mode does this automatically. 

3.1.3 Special Key Definitions 

Three special ASCII sequences may be defined for terminals that are 
not PC-compatible. Each special ASCII sequence specifies a partic¬ 
ular function to be performed when VP/ix receives the correspond¬ 
ing sequence. For the sake of convenience, the special sequences 
should correspond to the sequences sent from the terminal when a 
single special key on the keyboard is pressed. (A special key is any 
key other than those on the basic ASCII keyboard.) 
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The sequences k—up and k—down are used to support 24-line termi¬ 
nals. Defining either of these capabilities tells VP/ix that the termi¬ 
nal has only 24 lines and defines a key or keys to “rock” the screen 
up or down, showing either the first or last 24 lines of the true 25- 
line display. Note that k—up and k—down may have identical 
definitions (or only one of them may be defined); this means that 
the same key may be used to rock the screen up or down. Alterna¬ 
tively, k—up and k—down may be mapped to two different keys. 
One key will be used to rock the screen up, and another key will be 
used to rock the screen down. In this case, the bell will ring if the 
key mapped to k—up is used when the screen is already up or the 
key mapped to k—down is used when the screen is already down. 

Note that normal scrolling operations on a 24-line terminal should 
be performed with the screen rocked up, that is, with the 25th line 
showing. Having the screen rocked down slows scrolling and leaves 
the 25th line, which will contain the prompt when scrolling is com¬ 
pleted, invisible. 

The k—refr capability allows the terminal screen to be refreshed if it 
is disrupted due to output from extraneous processes (for example, a 
system message) or buffer overflows on a busy system. If the 
k—refr capability is defined, the screen can be refreshed by pressing 
the key to which k—refr has been mapped. 

3.1.4 pccompat 

The pccompat capability tells VP/ix whether your terminal is PC- 
compatible so that VP/ix knows whether to expect scan codes or 
ASCII characters from the keyboard. (Scan codes are numerical 
values that correspond to the position of the key on the keyboard.) 
Give pccompat the value y for PC-compatible terminals; otherwise, 
do not specify the pccompat capability. 

3.1.5 c—xon and c—xoff 

PC-compatible terminals may have alternate characters defined to 
act as the XON/XOFF handshaking characters, since sending the 
normal ASCII characters would conflict with the scan codes that 
coincide with those characters. If your terminal has alternate char¬ 
acters defined for handshaking, you must set C—xon and C—xoff to 
these one-character values. 
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3.2 ASCII Input to Scan Code Mappings 

On terminals that are not PC-compatible, the keyboard transmits 
the ASCII values of the keys pressed. In the case of special keys, 
sequences of ASCII characters may be transmitted. PCs and PC- 
compatible terminals, on the other hand, transmit scan codes. (One 
scan code, called a “make” code, is transmitted when the key is 
depressed, and another scan code, called a “break” code, is 
transmitted when the key is released.) For example, the ASCII a 
key, when shifted, transmits (octal) 101, the ASCII code for A. A 
PC application expects to see the (hex) scan codes 2A, IE, 9E, and 
AA in that order, corresponding to the make code for ISHIFTI , the 
make a nd break codes for the a key, and the break code for 
ISHIFTI . Therefore, there must be a mapping between ASCII input 
characters and the sequence of scan codes that a PC application 
expects to receive. 

/usr/vpix/term/sys. default, the VP/ix terminal- 
independent configuration file, contains the ASCII-to-scan code map¬ 
pings for all single ASCII characters, so these standard mappings 
need not be defined elsewhere. Note that if your terminal is PC- 
compatible, these input mapping specifications have no meaning 
(but do no harm) since VP/ix assumes that it is already receiving 
scan codes from the keyboard. 


There are, however, a number of keys on a PC keyboard that do not 
correspond to any ASCII character: the function keys, the three tog- 


gle keys (|CAPS-LOCK|, |NUM-LOCK|, | SCROLL-LOCK|), the nine- 

key numeric keypad, 1 INS 1, |DEL|, 

SYS-REOl, IPRT-SCI, -, and + 

on the numeric keypad, 

ALT|, CTRL , ILEFT-SHIFTI, and 


IRIGHT-SHIFTI . The last three do not transmit a character but, 
instead, modify the character transmitted by other keys. In order to 
communicate with all PC applications, it must be possible to “tell” 
VP/ix that each of these keys has been pressed. In fact, in the case 
of I ALT I , ICTRLI , I LEFT-SHIFT] , and I RIGHT-SHIFT] , it is necessary 
for some applications to know separately when these keys have been 
pressed (make code) and when they have been released (break 
code). 

The input: lines in the terminal configuration file allow arbitrary 
mappings between sequences of input ASCII characters and 
sequences of scan codes. The syntax of an input mapping line is: 

input: ASCII-sequence scancode-sequence 
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The ASCII sequence is a series of ASCII characters separated by 
dashes (-). An ASCII character is either a single printable charac¬ 
ter or an octal representation of a character (a backslash followed 
by three octal digits). The scan code sequence is a series of two- 
digit hex scan codes separated by dashes (-). 

If, for example, your terminal is extremely simple and has no extra 
keys whatsoever, you may decide to map particular PC keys to an 
ASCII sequence that begins with a 1 CTRL 1 z and has a second char¬ 
acter that is a mnemonic for the PC key. Part of this mapping 
might look like this: 


ASCII Sequence 


Scan Codes 


input: \032-1 

input: \032-2 

input: \032-3 

input: \032-> 

input: \032-\032 


3B-BB 

3C-BC 

3D-BD 

4B-CB 

1D-2C-AC-9D 


The first line specifies that when a user types 1CTRL| z (octal 032) 
followed by a 1 on an ASCII terminal, it will have the same effect 
as if the user had pressed and released the F1 key on a PC key¬ 
board, since 3B and BB are the make and break codes for the F1 
key. The next two lines allow a user to emulate F2 and F3, respec¬ 
tively. The fourth line maps the curso r-right key on the PC key¬ 
board (the 6 on the numeric keypad) to I CTRL | z followed by > on 
the ASCII keyboard. 


Since the first character of any such multiple-character ASCII 
sequence is now special in that it no longer actually transmits its 
own “normal” scan code sequence, it is necessary to provide a 
sequence that does transmit its normal scan codes. Thi s is illu s- 
trated in the fifth line above, which speci fies tha t typing |CTRL| z 
twice will send the scan codes for the PC I CTRL! make code, the z 
make and break codes, and the |CTRL| break code. 


It is important to note that the ASCII sequences above are com¬ 
pletely arbitrary, whereas each scan code corresponds to a particular 
key on the PC keyboard that is to be emulated. If your ASCII ter¬ 
minal has a number of extra keys that normally transmit a sequence 
of ASCII characters (typically starting with ESC, octal 033), you 
can map that ASCII sequence to a corresponding key on the PC key¬ 
board. In this case, you must also provide a sequence for actually 
typing ESC, which is used by many PC applications. 
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Note that since the characters \, and * are special characters in 
a terminal configuration file, you must enter them using their octal 
representation if they are to be used as actual characters in an 
ASCII input sequence. Sample mappings may be found in the VP/ix 
terminal configuration files located in /usr/vpix/term. 

3.3 Output Character Mappings 

In order to support serial terminals, it is necessary to allow map¬ 
pings from each of the 256 characters in the PC character set to the 
output character set of your terminal. In addition, even PC- 
compatible terminals require that control characters, namely octal 
000 thru 037 and 177, be somehow escaped if one desires to display 
the actual PC character for that code. 

In a VP/ix terminal configuration file, output: lines are used to 
perform this mapping. The syntax of an output: mapping line 
is: 


output: character character-sequence 

The character sequence has the same syntax as an ASCII character 
sequence in an input: mapping line, except that the characters 
\200 thru \377 make sense in this context, but not in an input con¬ 
text. The character is also the same as the ASCII sequence in an 
input: line but consists of a single character rather than a char¬ 
acter sequence. 

The default output mappings contained in 
/usr/vpix/term/sys . default simply map every charac¬ 
ter to itself, except for the control characters mentioned above. 
VP/ix maps each of these control characters to ESC (octal 033) fol¬ 
lowed by the octal equivalent of the control character itself, except 
for 000, which is mapped to a space (since 0 and space are identical 
in the PC character set). This default mapping will work on most 
PC-compatible terminals. 

If your terminal is not PC-compatible, you must decide what to map 
each of the characters 001 thru 037 and 177 thru 377 to, since they 
are typically not present in the character set of an ASCII terminal. 

As with i nput: lines, a great deal of flexibility is allowed in 
specifying output: lines. For example, you might map all of the 
above characters to a period (.), or you might try to find the ASCII 
character that looks most like the PC character (see a PC reference 
manual for pictures of the PC character set). If the ASCII terminal 
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has a graphics mode that supplies some of these characters, you can 
map the PC character to the escape sequence for getting into graph¬ 
ics mode, followed by the graphics character, followed by the escape 
sequence for getting out of graphics mode. This is a more costly 
procedure, in terms of time and processing, but since most of the 
characters output by a PC application are regular ASCII characters, 
the cost may be acceptable. 




VP/ix Maintenance Procedures — Release 1.1.0 


49 


Appendix B: VP/ix ERROR MESSAGES 
1. INTRODUCTION 

This section describes the three categories of messages displayed by 
the VP/ix Environment when an error occurs. The possible causes 
of each error are indicated (cause) and recommendations for resolu¬ 
tion are made (action). Messages having the same cause and action 
are grouped together. Otherwise, messages are presented alphabeti¬ 
cally within categories. The VP/ix errors can be loosely grouped 
into three categories: 

• Configuration errors, which result from an improper environment 
or a lack of system resources. These errors may be resolved by 
making the appropriate changes in the VP/ix user or system 
environment or in the surrounding UNIX environment. 

• Faulty program errors, which result from user programs that 
attempt to access or control reserved parts of the system or to do 
something that is illegal even in a native DOS environment. Fix¬ 
ing the offending program typically solves these problems. 

• VP/ix internal errors, which usually occur when the VP/ix pro¬ 
gram is being executed with a UNIX kernel that does not sup¬ 
port the VP/ix Environment. Contact your VP/ix vendor if you 
encounter one of these messages. 

If the VP/ix Environment displays an error message that is not 
listed in this appendix and that is not self-explanatory, contact your 
VP/ix vendor. 
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2. CONFIGURATION ERRORS 

A configuration error indicates a problem in the usage of VP/ix or a 
problem in the surrounding UNIX environment. The VP/ix program 
interfaces with the UNIX environment by making a set of requests 
(called system calls) to the UNIX kernel. Most of the error mes¬ 
sages listed in this section are a result of failed system calls. Under 
normal circumstances, system calls should succeed. However, if the 
UNIX environment is improperly configured, these error messages 
are likely to occur. 

Can't execute progname: unix—error 
Exec failed unix—error 

Cause: An attempt to execute a UNIX program from within 

the VP/ix Environment has failed. This error message 
indicates that there may be a problem with the UNIX 
variable SHELL or the program /bin/sh, which is 
used to execute the program. 

Action: Exit VP/ix and make sure that the /bin/sh file 
exists and that the variable SHELL is set to the name 
of a UNIX shell program or that it is not set at all. 
Other possible causes for this error message are indi¬ 
cated by the value unix—error, which indicates the 
UNIX error number of the failed exec system call. 
Refer to exec{ 2) for a description of these values. If 
the unix—error is Not enough space, you may 
need to increase the amount of swap space on the 
UNIX system. Refer to “386/ix Maintenance Pro¬ 
cedures” or the Operations/System Administration 
Guide. 

Cannot open file for saving virtual PC state 

Cause: The user has attempted to run a DOS command from 

UNIX or to quickboot VP/ix using the vpix -r 
command. The VP/ix program has attempted to 
create the BOOT IMAGE file with the name specified 
in the user’s configuration file but the open system call 
has failed. This error message usually indicates a 
problem with access to or permissions on the file. 

Action: Make sure that the directory in which the 

BOOT IMAGE file is to be created exists and that it 
has write permission for the user. Refer to open( 2) 
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for more information about the possible causes of this 
error message. 

Cannot open /usr/vpix/etc/vpixdevs file 

Cause: The user has a nonstandard device activated in his or 

her vpix. cnf file, but VP/ix is unable to open the 
vpixdevs file to obtain information about it. 

Action: Check to see that /usr/vpix/etc/vpixdevs 

exists and has read permission for the user. 

Cannot open virtual terminal filename 

Cause: The VP/ix program has attempted to access another 

virtual terminal on the console screen, but the system 
call has failed. Typically, this error message occurs 
when the permissions for the UNIX virtual terminal 
device file filename are incorrect or the file has been 
deleted. 

Action: If the file with the given filename does not exist, con¬ 

tact your 386/ix vendor for information on how to 
recreate it. If the file does exist, make sure it has the 
permissions 666 (read and write for all users). 

NOTE: This error does not occur on MULTIBUS 
systems. 

Cannot write file for saving virtual PC state 

Cause: The VP/ix program has attempted to save a 

BOOTIMAGE file with the name specified in the 
user’s configuration file. A write error occurred while 
writing out the VP/ix image. 

Action Make sure that the file system to which this file is 
being written contains enough space (the VP/ix image 
is over 100K bytes long). Also, make sure that the 
user’s ulimit value is large enough to handle a file of 
this size. Refer to ulimit(2) for information about 
setting the ulimit value. Refer to write{2) for more 
information about other causes of this error message. 
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Couldn't get info on device name from 
/usr/vpix/etc/vpixdevs file 

Cause: The user has specified a logical device name in their 

VP/ix configuration file, vpix.cnf, which was not 
found in the VP/ix device definition file. 

Action: Check for typographical errors and ensure that the 

device specified has been correctly configured into the 
VP/ix Environment with the vconf ig utility. 

DMA conflict between device namel and name2 

Cause: An attempt has been made to use device namel. 

VP/ix has detected a potential DMA conflict between 
this attempt and the use of the existing device name2. 

Action: Resolve conflict by using only one device at a time or 

reconfiguring the hardware to avoid the conflicts. 

Error unix—error encountered opening file filename 
as drive drive—letter 

Cause: While attempting to open the UNIX file filename, 

which is mapped to the DOS drive drive—letter in the 
user’s configuration file, VP/ix encountered the 
unix—error named in the error message. The entry 
for the drive—letter in the user’s configuration file may 
be set to a file that does not exist, or the permissions 
on the specified file may not allow read access. This 
error message may also be generated if the user 
attempts to access the file when it is locked by another 
user, since only one user at a time may open certain 
files. 

Action: Make sure that the file exists and that the read per¬ 

mission on it is set appropriately. Refer to open( 2) 
for other possible causes of this error message. 

Error unix—error opening ROM file filename 

Cause: The ROM or EGAROM file filename specified in the 

user’s configuration file could not be opened. The user 
must have read permission on these files. 

Action: Make sure the file exists and that read permission on 

it is set appropriately. Refer to open{ 2) for other pos¬ 
sible causes of this error message. 
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Error unix—error opening configuration file 
filename 

Cause: The VP/ix configuration file could not be opened. It 

is also possible that the configuration file was found 
but did not have the necessary read permission set for 
the user. 

Action: Make sure that the user’s home directory contains a 

vpix/vpix • cnf file or that the file named in the 
user’s VPIXCNF variable exists. Also make sure that 
the read permission on the configuration file is set 
appropriately. Refer to open{ 2) for other possible 
causes of this error message. 

Error unix _ error opening mouse file filename 

Cause: The VP/ix program is unable to access the mouse 

device as specified in the user’s configuration file. 
This error message may also be generated if the user 
attempts to access the device when it is already locked 
by another user, since only one user at a time may 
access the device. 

Action: Make sure that the MOUSE entry in the VP/ix 

configuration file is set to an existing UNIX device file 
and that the permissions on the specified UNIX device 
file provide read access to the user. If another user 
has accessed the MOUSE device, wait until the device 
is released before attempting to access it again. Refer 
to open{ 2) for other possible causes of this error 
message. 

NOTE: Mouse entries should not be defined on MUL¬ 
TIBUS systems. 

Error unix—error opening terminal configuration 
file filename 

Cause: The terminal configuration file filename specified by 

the user’s TERM environment variable could not be 
opened. If the unix—error is No such file or 
directory, then the terminal configuration file 
filename does not exist. This error message may be 
generated when the TERM environment variable is set 
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to a terminal type that is not supported by the VP/ix 
Environment. 

Action: You must create a terminal configuration file for this 

terminal before VP/ix can be run on it (refer to 
Appendix A). If the unix—error is Permission 
denied, then the permissions on the terminal 
configuration file filename do not allow the user to 
read it. Make sure that the permissions on the 
configuration file provide read access to the user. 
Refer to open( 2) for other possible causes of this error 
message. 

Error attempting to open serial device 

Cause: The serial device entry (COM1, COM2, 

COM 1 MOUSE, or COM2MOUSE) specified in the 
user’s configuration file could not be opened. This 
error message may occur when one of the entries in 
the VP/ix configuration file is set to a file that does 
not exist or when the file exists but does not have the 
necessary read or write permissions set for the user. 
This error message may also occur if the device is 
already being accessed by another user, since only one 
user at a time may access a COM1 or COM2 device. 

Action: Make sure that the serial device entry in the 

configuration file is set to an existing file and that the 
file permissions allow the user read and write access. 
If the device is already being accessed by another 
user, wait until the device is released before attempt¬ 
ing to access it again. Refer to open{2) for other pos¬ 
sible causes of this error message. 

NOTE: Serial device entries should not be defined on 
MULTIBUS systems. 

Fork failed unix—error 

Unable to fork new process : unix—error 

Cause: An error occurred when an attempt was made to exe¬ 

cute a shell. The value unix—error indicates the 
UNIX error number of the failed fork system call. 

If the unix—error is No more processes, you 
may need to increase the number of UNIX processes 


Action: 
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allowed on your system. If the unix—error is Not 
enough space, you may need to increase the 
amount of swap space on your UNIX system. Refer 
to “386/ix Maintenance Procedures” or the 
Operations/System Administration Guide. Refer to 
fork{ 2) for other possible causes of this error 
message. 

Interrupt conflict between device namel and 

name2 

Cause: An attempt has been made to use device namel. 

VP/ix has detected a potential interrupt conflict 
between this attempt and the use of an existing device 
name2. 

Action: Resolve conflict by using only one device at a time or 

reconfiguring the hardware to avoid the conflicts. 

Invalid command line parameter: arg 

Cause: The user has invoked the vpix program with an 

invalid argument arg. 

Action: Refer to vpix(l) for information about valid argu¬ 

ments to the vpix program. 

line line—number : input sequence too long 
1 (max : max—num) 

Cause: An input key mapping in the terminal configuration 

file has too many input characters. 

i Action: You must shorten the number of input characters on 

the specified line _ number. If this input character 

I sequence corresponds to what a single key on the ter¬ 

minal sends, it will not be possible to provide a map- 
i ping for this key on the terminal. The maximum 

number of input key mappings is indicated in 
I max—num. Refer to Appendix A for more informa¬ 

tion about mapping input sequences. 

I/O register conflict between device namel and 
| name2 

Cause: An attempt has been made to use device namel. 

! VP/ix has detected a potential I/O register conflict 
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between this attempt and the use of an existing device 
name2. 

Action: Resolve conflict by using only one device at a time or 

reconfiguring the hardware to avoid the conflicts. 

line line—number: scancode sequence too long 
(max : max—num) 

Cause: An input key mapping in the terminal configuration 

file has too many scan codes mapped to it. 

Action: You must shorten the number of scan codes on the 

specified line—number. The maximum number of 
scan code mappings is indicated in max—num. Refer 
to Appendix A for more information about mapping 
input sequences. 

line line. — number: too many mappings 
(max : max—num ) 

Cause: The terminal configuration file has too many input key 

mappings. These are lines that begin with the string 
input: and indicate key sequences to be mapped to 
scan code sequences. 

Action: You must delete some of these input key mappings in 

order to run VP/ix on this terminal. The maximum 
number of input key mappings is indicated in (max: 
max—num ). Refer to Appendix A for more informa¬ 
tion about mapping input sequences. 

line line—number: unknown terminal capability 
capname 

Cause: A line in the terminal configuration file begins with an 

unknown keyword capname. Only the capabilities 
listed in Appendix A may be specified. 

Action: Change the entry in the configuration file to match 

one of the capabilities listed in Appendix A. 

Memory conflict between device namel and name2 

Cause: An attempt has been made to use device namel. 

VP/ix has detected a potential memory conflict 
between this attempt and the use of an existing device 
name2. 
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Action: Resolve conflict by using only one device at a time or 

reconfiguring the hardware to avoid the conflicts. 

No virtual terminals available 

Cause: The VP/ix program has attempted to access a new vir¬ 

tual terminal but the attempt has failed. 

Action: You must terminate one or more processes running on 

the virtual terminals before additional virtual termi¬ 
nals can be used. Log out of a virtual terminal, or use 
the sysadm virtterm command to decrease the 
number of active virtual terminals. 

NOTE: This error does not occur on MULTIBUS 
systems. 

Printer put error 

Cause: An error occurred while data was being sent to the 

printer process specified in the LPT 1, LPT2, or 
LPT 3 entry of the user’s configuration file. This error 
message may be generated by an unrecoverable disk 
error. 

Action: Refer to write( 2) for more information about write 

errors. 

TERM variable is not set 

Cause: The TERM variable has not been set. In order for 

VP/ix to run on a terminal other than the console, the 
environment variable TERM must be set. 

Action: Make sure that the user’s TERM variable is set to the 

type of terminal being used and that the terminal has 
been exported. This is typically done in the user’s 
. prof i le file. 

Terminal configuration file filename has errors : 

Cause: A problem has been detected with the structure of the 

terminal configuration file filename. The subsequent 
error messages will specify the problem. 

Action: The action to be taken will depend on the specific 

error message. 
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Unable to complete ioctl 

Cause: The built-in Direct Device Attachment (DDA) 

mechanism is attempting to gain direct access to a 
device specified by the user. However, the UNIX sys¬ 
tem has found that permitting this action will cause a 
conflict with another device in the system. VP/ix will 
be denied its request and the device will not be 
accessible. 

Action: The administrator should ensure that the DDA device 
is not being accessed by another program. All 
attached peripherals on the system should then be 
checked for conflicts and those conflicts should be 
resolved. 

Unable to open generic device name 

Cause: The user has an entry with a given name in his or her 

VP/ix configuration file, which VP/ix is unable to 
open. This entry corresponds to a Direct Device 
Attachment (DDA) device, which requires a UNIX 
special file in the /dev directory. 

Action: Generally, the device cannot be opened either because 

the special file in the /dev directory does not exist or 
because the permissions on that entry do not allow 
access to the device. Also, if the device is being used 
by another user, this error message will appear and is 
considered a normal consequence of attempting to 
share a DDA-type device. The other user must exit 
VP/ix before this user will be able to enter VP/ix. 

v86init() failed: unix—error 

Cause: The system call used to initialize the VP/ix Environ¬ 

ment has failed. If the unix—error is Not owner, 
the failure occurred because the vpix program 
(/usr/bin/vpix) is not owned by root or does 
not have the permissions 4755. 



VP/ix Maintenance Procedures — Release 1.1.0 


59 


Action: Use the UNIX chown and chroot commands to 

change the owner or the permissions, as appropriate. 
If the unix—error is No more processes, you 
must allocate more swap space for your UNIX system. 
Refer to “386/ix Maintenance Procedures” or the 
Operations I System Administration Guide. 

VPIX not linked to include IEM module for device 
name 

Cause: The user has specified a logical device name in the 

VP/ix configuration file, vpix.cnf, which contains 
an entry in the VP/ix device file. However, VP/ix has 
not been correctly configured (built) to include sup¬ 
port for the specified device. 

Action: Check that the device has been correctly configured 

into the VP/ix Environment with the vconfig 
utility. 
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3. FAULTY PROGRAM ERRORS 

The VP/ix Environment provides compatibility with standard DOS 
devices and functions. However, there are certain “ill-behaved” 
applications that use nonstandard devices or port addresses. These 
applications will usually cause errors in the VP/ix Environment and 
should be avoided. A user-written DOS program that is faulty (for 
example, one that attempts to divide by zero) and would normally 
cause a problem under native DOS will also cause one of the mes¬ 
sages listed below to be generated. In this case, the user should fix 
the offending program. 

Application attempted to enter protected mode 

Cause: This DOS application attempted to enter 80286 pro¬ 

tected mode. 

Action: This is not a true 8086 DOS application, and it is not 

supported in the VP/ix Environment. 

Error reading serial device 

Cause: An error occurred while data was being read from the 

serial device. This error may have been caused by a 
lost carrier (for example, a disconnected phone line). 
Another possible cause is that the DOS application has 
attempted to read from a serial port with a port 
number that is not valid. 

Action: Make sure that the appropriate phone lines are con¬ 

nected, and make sure that the serial port is assigned 
a valid port number. 

NOTE: COM1 and COM2 should not be defined on 
MULTIBUS systems. 

Error writing serial device 

Cause: An error occurred while data sent to the serial device 

was being written. This error may have been caused 
by a lost carrier. Another possible cause is that the 
DOS application has attempted to write to a serial 
port with a port number that is not valid. 

Action: Make sure that the appropriate phone lines are con¬ 

nected, and make sure that the serial port is assigned 
a valid port number. 
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NOTE: COM1 and COM2 should not be defined on 
MULTIBUS systems. 

General protection fault, cannot emulate 
instruction 

Cause: The DOS program has caused a General Protection 

Fault. VP/ix is unable to emulate the specified 
privileged instructions. Possible causes of this error 
are: 

• An instruction fetching or storing a word at loca¬ 
tion Oxffff (65535), which would cause the next 
address to become too large. 

• An instruction with an “addr32” (0x67) prefix in 
front of it, causing an address that is bigger than 
OxfiffT (65535). 

• An attempt to execute privileged instructions. 

• An attempt to execute an 8086 “pop cs” instruc¬ 
tion. This instruction was removed from Intel pro¬ 
cessors after the 8086, and cannot be emulated in 
VP/ix. 

• Too many instruction prefixes in front of an 
instruction. 

• Any other reason that would cause a General Pro¬ 
tection Fault in a Virtual 8086 Mode process. 

Action: Make sure that the offending program runs correctly 

under native DOS. It if does not, then fix the pro¬ 
gram. Refer to the Programmer’s Reference Manual 
for more information about the possible causes of this 
error. 
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Int 1 3 ( ) 
Cause: 


Action: 

Invalid 

Cause: 

Action: 

Invalid 

Cause: 

Action: 

PR_CMOS 

PR_CMOS 

Cause: 


: Function = functioncode 

An attempt has been made to read or write input or 
output to a DOS file system image with the int 13 
instruction in a way that is not supported by VP/ix. 
The value of functioncode gives the hexadecimal value 
of the AH register for the int 1 3 call. 

This program cannot be run under VP/ix. 

interrupt service routine number 

The DOS application has attempted an int 1 (trace 
trap), int 3 (breakpoint), or int 4 (overflow trap) 
instruction that VP/ix has been unable to emulate 
correctly. 

Make sure that the offending DOS program runs 
correctly under native DOS. If it does not, then fix 
the program. 

magic request data 

The DOS process has attempted to write to a VP/ix 
reserved port. The hexadecimal value data indicates 
the invalid data that is being output. 

The application must be modified so that it does not 
use this port. 

: Bad read from port 
: Bad write of data to port 

The DOS program has attempted to execute an in or 
out instruction at the hexadecimal value port. This 
value is in the range of the CMOS ports (0x70 to 
0x7f), but it is not a valid or emulated VP/ix port. 

You must correct the invalid instruction. 


Action: 
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Printer general error 

Cause: An attempt has been made to read from or write to a 

printer or parallel port with a port number that is not 
implemented. 

Action: You must correct the invalid input or output 

instruction. 

Unable to emulate two-byte instruction 

Cause: An 80386™ two-byte opcode (one beginning with the 

byte Oxf) cannot be emulated. This implies that the 
DOS application is doing something abnormal. 

Action: Verify that the program that generated the error mes¬ 

sage runs correctly under native DOS. If it does not, 
correct the program. If it does, report the problem to 
your VP/ix vendor. 
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4. VP/ix INTERNAL ERRORS 

The VP/ix program requires special support from a customized 
UNIX kernel that is supplied with your 386/ix Operating System. 
Most of the errors listed in this section result from using the VP/ix 
program with a nonstandard kernel that is not enhanced to support 
the VP/ix Environment. Other VP/ix internal errors are indicative 
of serious problems with the VP/ix program itself. These errors 
should be reported to your VP/ix vendor. 

Can't map memory 

Can't track memory: unix—error 

Couldn't Re-track VRAM 

Cause: An error was encountered while VP/ix was trying to 

set up access to the screen memory. 

Action: Report this error to your VP/ix vendor. 

Can't query VT manager: unix—error 
Can't set scan mode for AT kbd 
Can't set scan mode in kbd 

Can't set virtual terminal mode: unix—error 
Can't set virtual terminal text mode: unix—error 
Couldn't set kbd INTTYPE 
Couldn't set VT mode: unix—error 
Couldn't get VT mode: unix—error 

Cause: An attempt to access the UNIX console driver has 

failed. A possible cause is that the UNIX kernel does 
not have the proper console driver support for VP/ix. 

Action: You must use a standard 386/ix kernel. 

Couldn't map EGA ROM: unix—error 
Couldn't unmap EGA ROM: unix—error 

Cause: An error was encountered trying to set up or release 

access to the EGA ROM. 

Action: Report this error to your VP/ix vendor. 

Internal error : ect_main returned 

Cause: An unexpected internal error in VP/ix has occurred. 

Action: This error should be reported to your VP/ix vendor. 
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Error attempting to initialize mouse 

Cause: An attempt to initialize the mouse device for reading 

has failed. A possible cause is that the mouse driver 
in the UNIX kernel does not have the proper support 
for the mouse device. 

Action: You must use a standard 386/ix kernel. 

NOTE: Mouse devices are not currently supported on 
MULTIBUS systems. 

Error attempting to send out to serial 

Cause: An attempt to emulate the serial communications port 

on the terminal represented by the COM device has 
failed. A possible cause is that modifications neces- 
1 sary for VP/ix to run on the terminal have not been 

, configured into the UNIX kernel. 

Action: You must use a standard 386/ix kernel. 

i NOTE: COM devices are not currently supported on 

3 MULTIBUS systems. 

i 

Error attempting to send serial info 
j Error attempting to set DOS mode 

Error attempting to set non-DOS mode 
j Error sending serial int type 

Cause: An attempt to set the terminal representing the COM 

1 device into a special mode for VP/ix has failed. The 

probable cause of this error message is that 
• modifications necessary for VP/ix to run on the termi- 

j nal have not been configured into the UNIX kernel. 

Action: You must use a standard 386/ix kernel. 

i NOTE: COM devices are not currently supported on 

j MULTIBUS systems. 

Error setting line for serial device 

i Cause: An error has occurred when VP/ix attempted to get or 

set the terminal characteristics, such as the baud rate, 
I from the serial device. This error may have been 

caused by a lost carrier. 
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Action: Make sure that the phone line has not been 

disconnected. 

Map to NULL failed 

Cause: An error was encountered when VP/ix attempted to 

set up access to a null page of memory. 

Action: This error should be reported to your VP/ix vendor. 

Seek( ) : lseek( ) failed, errno = Unix— error 

Cause: An error has occurred when VP/ix attempted to posi¬ 

tion to read or write a DOS file system image. 

Action: Report this error to your VP/ix vendor. Refer to 

lseek{2) for other possible causes of this error 
message. 

Segmentation violation 

Cause: The VP/ix process has received a signal 11 from 

the UNIX system. This is either because another 
UNIX process has sent this signal (for example, the 
kill command), or there is an internal error in 
VP/ix. 

Action: First, check whether the problem is being caused 

intentionally by another process, by repeating the con¬ 
ditions that resulted in the message. If it is repeat- 
able, contact your VP/ix vendor. 
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Appendix C: INCOMPATIBILITIES BETWEEN DOS AND VP/ix 

While the majority of DOS applications will run successfully under 
VP/ix, a small number of applications rely on functions, such as 
tight control of the hardware interface, that are impossible to emu¬ 
late within the VP/ix Environment. Such known areas include: 

• Real-time timing dependencies (e.g., games, music). Such appli¬ 
cations will run properly, but due to the fact that in reality they 
are running under a multi-tasking environment (i.e., UNIX), 
they may appear discontinuous or slow if other users are busy on 
the system. 

• Heavy programming of the DMA controller chip (as is done by 
Fastback™) and unusual or undocumented features of other 
chips that are emulated under VP/ix. 

• Access to nonstandard PC hardware (e.g., tape drives, network 

j adapters, nonstandard display adapters, synchronous communica¬ 

tions or RS-422 adapters, scanners, or CD-ROM drives). If such 

j devices are not configurable using Direct Device Access, explicit 

support in the form of an Installable Emulation Module must be 
( provided by the hardware manufacturer. See §6 for further 

explanation of nonstandard devices. 

i • Applications that attempt to go into 80386 protected mode. 

These include multi-user DOS operating systems such as PC- 
i MOS and Concurrent DOS, as well as 386-specific versions of 

standard DOS applications such as MS Windows™ 386 and Para- 
i dox® 386. Such applications truly take over the machine in a 

way which is incompatible with running under 386/ix. 

’ • Applications or commands which attempt to directly manipulate 

| parts of the DOS file system. Such applications will work on the 

A, B, or C drives, but not on the Z drive, which is actually the 
• UNIX file system. There are very few such applications (Norton 

Utilities “unerase” command is one), but there are a number of 
j standard DOS commands that do this. Such commands should 

produce an error when run on the Z drive saying that they can- 
_ not work on a “networked” drive. 

• Direct access to the fixed disk controller registers; all fixed disk 

i access must be via BIOS or higher level calls. 

i • Applications that require so much memory under DOS that they 

are unable to run if there are any terminate and stay resident 
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DOS programs loaded into memory. Under VP/ix, the file 
redirector is normally loaded and takes up about 20K of 
memory. If you encounter such an application, you may turn off 
the redirector using the dosmount command and run it, but of 
course you will not have access to the Z drive while the redirec¬ 
tor is not running. 

• EGA-generated interrupts. 

• The Softguard copy protection scheme. 

• INT 15 extended memory calls. Certain other BIOS INTs that 
deal directly with hardware (such as the real-time clock) are 
also not supported. There are no known applications that use 
these unsupported BIOS INTs. 
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NAME 

csh — a shell with C-like syntax, VP/ix addendum 

NEW ENVIRONMENT VARIABLE 

The new environment variable described in this section has been added 
to the C shell. 

DOSPATH The C shell will behave normally for those users who do 
not set DOSPATH. Users who wish to be able to execute 
DOS programs directly from the C shell, i.e., bypassing the 
normal DOS bootup that occurs when running vpix, should 
set DOSPATH to include those directories in PATH that 
contain DOS executables. 

DOSPATH is a string with the same format as PATH; it 
contains a subset of the list of directories from PATH. 
When searching a directory in PATH for a program, the C 
shell determines whether that directory is also in 
DOSPATH. If it is not, the C shell acts as usual. If it is, 
the C shell looks first for the command with the suffix 
.com, then .exe, then .bat, and finally, for the command 
without any suffix. Whenever the result of a path search 
gives a file with one of these DOS suffixes, the shell runs 
the vpix program via the standard search path and adds 
arguments —c and the full path name of the DOS program 
(including the suffix). 

EXAMPLE 

If PATH is set to .:/bin:/usr/bin, DOSPATH is set to ., the current 
directory is /usr/john/dosbin, and there is a DOS program named 
abc.com in the current directory, then typing abc to the C shell will 
cause the command vpix —c /usr/john/dosbin/abc.com to be executed, 
which will run the DOS program abc.com without the normal vpix 
DOS bootup. 

SEE ALSO 

vpix(l). 
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NAME 

sh, rsh — standard or restricted shell, VP/ix addendum 

NEW ENVIRONMENT VARIABLE 

The new environment variable described in this section has been added 
to the shell. 

DOSPATH The shell will behave normally for those users who do not 
set DOSPATH. Users who wish to be able to execute DOS 
programs directly from the shell, i.e., bypassing the normal 
DOS bootup that occurs when running vpix, should set 
DOSPATH to include those directories in PATH that con¬ 
tain DOS executables. 

DOSPATH is a string with the same format as PATH; it 
contains a subset of the list of directories from PATH. 
When searching a directory in PATH for a program, the 
shell determines whether that directory is also in 
DOSPATH. If it is not, the shell acts as usual. If it is, the 
shell looks first for the command with the suffix .com, then 
.exe, then .bat, and finally, for the command without any 
suffix. Whenever the result of a path search gives a file 
with one of these DOS suffixes, the shell runs the vpix pro¬ 
gram via the standard search path and adds arguments —c 
and the full path name of the DOS program (including the 
suffix). 

EXAMPLE 

If PATH is set to .:/bin:/usr/bin, DOSPATH is set to ., the current 
directory is /usr/john/dosbin, and there is a DOS program named 
abc.com in the current directory, then typing abc to the shell will cause 
the command vpix —c /usr/john/dosbin/abc. com to be executed, which 
will run the DOS program abc.com without the normal vpix DOS 
bootup. 

SEE ALSO 

vpix(l). 


VP/ix 


- 1 - 


Release 1.1.0 



vconfig(1) 


vconfig (1) 


NAME 

vconfig — configure, build, and install vpix 

SYNOPSIS 

vconfig 

DESCRIPTION 

The vconfig command provides a menu-driven mechanism for modify¬ 
ing the configuration parameters associated with nonstandard (IEM 
and DDA) devices that are defined in the file /usr/vpix/etc/vpixdevs. 
This program should be run only when no users are running the vpix 
program. 

The program’s top-level display lists all defined IEM and DDA devices 
and offers menu options to display an additional screenful of device 
names (in case more devices have been defined than may be displayed 
on a single screen), to modify the parameters associated with a device, 
to exit and update VP/ix, or to exit without changes. 

If the user chooses to make changes, vconfig prompts for the logical 
name of the device to be modified; a second menu is then displayed, 
from which the user may choose one or more of the following device 
configuration parameters for modification: 

The range of I/O ports used by the device 
The range of controller memory used by the device 
The interrupt vector used by the device 
The DMA channel used by the device 
The UNIX special device file associated with the device 
The device’s “configuration flag” (when set to Y, the device is 
accessible by VP/ix users; when set to N, the device is not 
accessible) 

Additional menus and forms then guide the user through the process of 
making changes to selected parameters. If the user attempts to enter 
parameters that conflict with VP/ix’s built-in (fixed) devices, the 
changes are rejected. The program will not prohibit the entry of 
parameters that conflict with other DDA or IEM devices, although it 
does issue a warning. (VP/ix performs additional checks at runtime to 
ensure that a VP/ix user does not attempt to access two devices that 
conflict with each other.) 

Ample opportunity is given to cancel or “undo” changes made in error. 

When all the necessary changes have been made, the user may choose 
to exit without change, or to update VP/ix and exit. If the changes 
are retained, and modifications have been made to IEM device 
configuration parameters, vconfig rebuilds the vpix program, incor¬ 
porating the changes as necessary. 

FILES 

/usr /vpix / etc /vconfig 
/usr / vpix/etc / vpixdevs 

SEE ALSO . 

“Accessing Nonstandard Devices in the VP/ix Environment” in “VP/ix 
Maintenance Procedures.” 
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WARNINGS 

The vconfig command may not be used to “register” or “deregister” 
nonstandard devices with VP/ix, but only to modify the parameters of 
devices that are already registered. DDA devices are registered and 
deregistered by means of the syadm vpixmgmt menu options ddain- 
stall and ddaremove\ the corresponding menu options for IEM devices 
are installpkg and removepkg on the System Administration Software 
Management submenu. Note however that registered devices may be 
“installed” and “deinstalled” by using vconfig to toggle the value of 
the configuration flag. 

vconfig does not prohibit the entry of parameters that conflict with 
other IEM or DDA devices, although it does warn of the situation. An 
individual user’s vpix.cnf file may define only one of any such 
conflicting devices. 
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NAME 

vpix — create a virtual PC process 

SYNOPSIS 

/usr/bin/vpix [ —c command ] [ —r [ image ] 1 [ —n ] [ —b ] 
DESCRIPTION 

Vpix creates and monitors a VP/ix virtual PC, and also provides a user 
interface to it. The virtual PC is a special process that executes in 
both Virtual 8086 mode and Protected mode, and runs DOS and DOS 
applications in a virtual environment equivalent to an IBM PC AT run¬ 
ning in Real mode. After finding the various files required for initiali¬ 
zation, vpix creates a virtual PC memory region, loads a BIOS into it 
from the appropriate source, and begins execution in Virtual 8086 
mode. 

Vpix can be invoked from any asynchronous serial terminal or from a 
virtual terminal on a PC AT-compatible memory-mapped system con¬ 
sole device. DOS graphics applications can run only on the latter. The 
Monochrome Display Adapter is emulated on serial terminals, and 
only text-mode DOS applications are supported. A TERM variable in 
the environment, and a matching file in the /usr/vpix/term directory, 
are required for serial terminal support. If no matching file is found in 
/usr/vpix/term, then /usr/vpix/term/generic is used. If the environ¬ 
ment variable VPIXTERMDIR is set, it is searched after 
/usr/vpix/term. See the “VP/ix Maintenance Procedures” for the for¬ 
mat of a VP/ix terminal description file. 

Options 

—c command 

Execute the command as the first DOS program instead of 
the DOS shell (COMMAND.COM, which is the default), 
and terminate the virtual PC when the command ter¬ 
minates. This option is the method used by the Bourne 
and C shells to execute DOS commands directly from the 
UNIX shell prompt. 

—r [ image ] 

Initialize vpix quickly from a file containing the image of a 
virtual PC. If image is not specified, the configuration file 
BOOTIMAGE specification (see below) is used. If the 
image file does not exist or is out-of-date with respect to 
the user’s current hardware configuration, it is recreated 
automatically by VP/ix. 

—n Normally, if conditions such as the inability to open device 

files are encountered when vpix is invoked, a m essage is 
displayed and the user is prompted to press the [ENTERI 
key. If this option is specified, the warning messages will 
still be displayed, but the vpix boot will continue without 
user intervention. This is a useful option for running vpix 
in a noninteractive environment. 

—b Normally, vpix does not attempt to boot off of a DOS par¬ 

tition on the DOS A: device, even if is is specified in the 
configuration file A specification (see below). If this option 
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is given, it will attempt to boot off of A: if A is specified in 
the configuration file. 

Configuration 

Vpix uses a configuration file to map virtual DOS devices to real UNIX 
devices, files, or programs, and also to provide certain other informa¬ 
tion to the Emulation Control Task of the virtual PC. If the environ¬ 
ment variable VPIXCNF is present when vpix starts up, it is taken as 
the full path name of the configuration file. If VPIXCNF is not present, 
then vpix searches for the file vpix.cnf first in the directory 
$HOME/vpix, then in /usr/vpix/defaults. 

The configuration file is an ASCII text file that consists of comment 
lines and configuration lines. A comment line is any line beginning 
with the semicolon (;) character. A configuration line consists of two 
fields separated by spaces or tabs. The first field is a keyword, usually 
the logical name of a DOS device. The second field is a corresponding 
value that is associated with the keyword, usually the name of a UNIX 
device or file. The valid keywords are: 

A, B, C, D 

One of the uppercase set A-D corresponding to a DOS disk or 
diskette volume. No colon is required. The value may be a 
UNIX device or the name of a UNIX file containing an image 
of a DOS file system. These drive letters have no defaults and 
are emulated only if present in the configuration file. Nor¬ 
mally, drive C is mapped to either $HOME/vpix/C: or 
/usr/vpix/defaults/C:, depending on the user’s requirements. 

COMaz where n is 1 or 2. The value must be the name of a UNIX 
asynchronous character device special file. COM2 should not 
be specified unless COM1 is also specified. 

COMaz MOUSE 

where n is 1 or 2. The value must be the name of a UNIX 
asynchronous character device special file to which a serial 
mouse is attached. COM2MOUSE should not be specified 
unless COM 1 MOUSE is also specified. If no COMaz or 
COMazMOUSE entry is specified, the DOS serial port is not 
emulated. 

LPTaz where n is 1, 2 or 3. The value must be a string (which must 
be quoted if it contains spaces) that can be passed to the 
UNIX system^ 3) library routine. Buffered print data is passed 
to the resulting child process through a pipe. If there is no 
LPT entry in the configuration file, the DOS parallel port is not 
emulated. LPT2 should not be specified unless LPT1 is also 
specified, and LPT3 should not be specified unless both LPT1 
and LPT2 are also specified. 

MOUSE 

The value must be the name of a UNIX character device spe¬ 
cial file, e.g., /dev/mouse (for a Microsoft InPort Bus Mouse). 
If this keyword is not present, no mouse emulation is 
performed. 
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ROM The BIOS image file. This is normally the file 

/usr /vpix/defaults/rom. 

EGAROM 

The EGA BIOS image file. This is normally the file 

/usr/vpix/defaults/romega. On systems without an EGA, this 
keyword is ignored. 

VGAROM 

The VGA BIOS image file. This is normally the file 

/usr/vpix/defaults/romvga. On systems without a VGA, this 
keyword is ignored. 

CMOS The CMOS emulation file. This is normally the file 

/usr/vpix/defaults/cmos. 


BOOTEMAGE 

The fast-load virtual PC image used when vpix is invoked with 
the — r option and no arguments. It is normally set to 
$HOME /vpix/vpix.img. 

Any other keywords found in the configuration file are looked up in the 
file /usr/vpix/etc/vpixdevs for a description of their characteristics. 
See “VP/ix Maintenance Procedures” for further information. 

Implicit Invocation 

Vpix can be implicitly invoked when the name of a DOS command is 
typed at the UNIX shell prompt. This facility permits users to execute 
DOS programs from within either DOS or UNIX. See csh{ 1), Adden¬ 
dum and sh( 1), Addendum. 


FILES 

/ usr /vpix/defaults / vpix.cnf 
$HOME/vpix/vpix.cnf 
/usr / vpix / def aults/cmos 
/usr /vpix/defaults/C: 
$HOME/vpix/C: 

$ HOME/vpix /vpix.img 
/usr /vpix/defaults / rom 
/usr /vpix / defaults / romega 

/ usr / vpix/defaults / romvga 

/usr / vpix/etc / vpixdevs 

/usr / vpix/term/sys. default 


/usr /vpix/term/* 


Default device configuration file 
Device configuration file 
CMOS emulation file 
Common bootable pseudo-disk 
Private bootable pseudo-disk 
Fast-load virtual PC image 
BIOS image file 

EGA BIOS image file, if running 
on EGA display 

VGA BIOS image file, if running 
on VGA display 

Descriptions of nonstandard 
devices 

Terminal-independent terminal 
description file, if running on 
serial terminal 

Terminal-dependent terminal 
description files, if running on 
serial terminal 


SEE ALSO 

csh(l) Addendum, sh(l) Addendum, vt(7), 

“VP/ix and MS-DOS Primer,” “VP/ix Maintenance Procedures.” 
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